Skip to main content
POST
/
api
/
v1
/
webhooks
/
{id}
/
test
Test Webhook
curl --request POST \
  --url https://api.example.com/api/v1/webhooks/{id}/test

​
Path Parameters

​
id
string
required
The webhook UUID.

​
Behavior

Dispatches a completion.created event with _test: true in the data payload. The delivery uses the same HMAC signing, SSRF checks, and retry logic as real events.

​
Example

curl -X POST https://hitheo.ai/api/v1/webhooks/WEBHOOK_ID/test \
  -H "Authorization: Bearer $THEO_API_KEY"

​
Response

{ "sent": true }

​
Test event payload your server receives

{
  "id": "evt_abc123...",
  "type": "completion.created",
  "created": "2026-04-15T12:00:00.000Z",
  "data": {
    "_test": true,
    "message": "This is a test event from Theo. If you received it, your webhook is working!"
  }
}
Use the delivery log to check whether the test was delivered successfully.