Skip to main content
POST
/
api
/
v1
/
events
Publish Event
curl --request POST \
  --url https://api.example.com/api/v1/events \
  --header 'Content-Type: application/json' \
  --data '
{
  "orgId": "<string>",
  "eventType": "<string>",
  "payload": "<any>",
  "sourceConnector": "<string>"
}
'
Publish a custom event to the Theo event bus. Events can trigger workflows, connector actions, and skill activations.

​
Authentication

Requires a Bearer token. See Authentication.

​
Request Body

​
orgId
string
required
Organization UUID the event belongs to.
​
eventType
string
required
Event type identifier (e.g., "claim.created", "policy.renewed").
​
payload
any
Arbitrary event payload data.
​
sourceConnector
string
ID of the connector that originated this event.

​
Request Example

curl -X POST https://www.hitheo.ai/api/v1/events \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "org_abc123",
    "eventType": "claim.created",
    "payload": { "claimId": "CLM-001", "amount": 15000, "type": "auto" }
  }'

​
Response

Returns the published event object with generated id and timestamp.

​
Endpoint

POST /api/v1/events Requires authentication via Bearer token. See Authentication.