webhook.test
A webhook event: the signed JSON body we send to your endpoints.
When it fires
Sent once when an endpoint is registered, to prove it. A 2xx makes the endpoint active.
We POST it to every active endpoint you registered with the Webhooks endpoints. A 2xx acknowledges it; anything else is retried. The webhooks guide covers delivery, retries and replays.
Headers
| Header | Description |
|---|---|
X-ShortsIntel-Signature | t=<unix seconds>,v1=<hex HMAC-SHA256 over "<t>.<body>">; two v1 during a rotation overlap. |
X-ShortsIntel-Event-Id | The event id, evt_..., same as the body's id. |
X-ShortsIntel-Event-Type | The dotted event type, same as the body's type. |
Payload
application/json, the same shape for every event; fields that do not apply to webhook.test are null or left out.
object
The thin webhook payload, exactly the bytes that were signed.
idstring required Event id,evt_.... Stable for one fact: a replay or a re-emission carries the same id, so dedupe on it.typestring required one ofrun.completed,tracker.changed,webhook.testrun.completed,tracker.changedorwebhook.test.created_atstring required formatdate-timeWhen the event was created.run_idstring required nullable The Run behind the event.kindstring required nullable The Run's kind, lower case, e.g.research.statusstring required nullablecompleted,partialorfailed.charge_creditsnumber required nullable What the Run cost, asGET /v1/runs/{id}shows it.tracker_idstring required nullable Ontracker.changed.change_report_idstring required nullable Ontracker.changed.collectionsarray of object Ontracker.changedonly: the Collections the Tracker sits in as of the event, by id and name, so you can route changes without a lookup. Absent on other events.idstring required The Collection's id.namestring required The Collection's name.
off_focus_countnumber nullable Ontracker.changedfor a Tracker with a Focus only: how many off-focus Videos the Change Report hid. The report's Videos are atlinks.changes.linksmap of string required Absolute URLs to fetch the detail with your own key:run,tracker,changes, andwebhookon a test event.
Example payload
Indented for reading. The bytes on the wire are compact, and the signature covers those raw bytes.
{
"id": "evt_kZ8Qw3n1TfLd0aZmVbYpRc",
"type": "webhook.test",
"created_at": "2026-09-08T09:14:02.911Z",
"run_id": null,
"kind": null,
"status": null,
"charge_credits": null,
"tracker_id": null,
"change_report_id": null,
"links": {
"webhook": "https://www.shortsintel.com/v1/webhooks/whe_6d2f10ab44"
}
}Verifying the signature
Verify the signature header against the raw body before you trust or parse it. The webhooks guide walks through it with a worked example and verifiers in TypeScript and Python: Verifying a signature.