Receive Smokeball events (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

POST /legal/smokeball/webhook

Called by Smokeball for matter and file events on the firm's single subscription. Requests must carry a valid signature, timestamp and request id (401 otherwise). Answers 200 without processing while the Smokeball integration is turned off, for changes Hearsay itself made and for duplicate events.

Headers

requestid string Required

application/json

Body Required

type string Required

Event type, e.g. 'matter.created'
subscriptionId string Required

Subscription that produced this delivery
accountId string Required

Smokeball firm/account id
userId string

Smokeball user that triggered the event
source string

Origin of the change
payload object

Event-specific payload (ids of the changed resource)
timestamp string

Event timestamp (provider-supplied)

Responses

200 application/json
Hide response attributes Show response attributes object
- statusCode number Required
- timestamp string(date-time) Required

POST /legal/smokeball/webhook

curl \
 --request POST 'http://api.example.com/legal/smokeball/webhook' \
 --header "Content-Type: application/json" \
 --header "requestid: string" \
 --data '{
  "type": "string",
  "subscriptionId": "string",
  "accountId": "string",
  "userId": "string",
  "source": "string",
  "payload": {},
  "timestamp": "string"
}'

Request examples

# Headers
requestid: string

# Payload
{
  "type": "string",
  "subscriptionId": "string",
  "accountId": "string",
  "userId": "string",
  "source": "string",
  "payload": {},
  "timestamp": "string"
}

Response examples (200)

{
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}