Skip to content

Ingest Event

POST /hooks/{workspace_id}/events/{event_kind}

Fan an event out to every subscribing schedule, capped and with the overflow reported.

Authentication is the unguessable workspace id in the path. That is weaker than the signed webhook path and §3 documents it as such; a workspace that needs more uses an endpoint with a secret.

NameInTypeNotes
workspace_idpathstring (uuid)required—
event_kindpathstringrequired—
StatusDescriptionBody
200Successful Response—
422Validation ErrorHTTPValidationError
Terminal window
curl -X POST https://your-deployment.example.com/hooks/{workspace_id}/events/{event_kind}