API referenceWebhooks
Webhook event delivery
Webhook event delivery
POST
your registered webhook endpointThis is an outbound event Videohati POSTs to your registered endpoint — you receive it, you do not call it.
Outbound POST Videohati sends to a customer-registered endpoint when
one of the 8 MVP events fires (delivery ships in Phase 9; the
envelope and signature scheme are locked here). Each delivery carries
the header Videohati-Signature: t=<unix_ts>,v1=<hex_sha256> where
the HMAC-SHA256 covers <unix_ts>.<raw_body> with the endpoint's
secret. Verify with constant-time comparison — the SDKs ship
webhooks.verify helpers for this.
Authentication
- This operation needs no authentication.
Request body
required
Content type: application/json
Schema: Event
{
"id": "01JZ9WV3N8GQ5T2M7K4C6XBARM",
"type": "video.encoding.ready",
"created_at": "2026-06-11T11:00:00.000Z",
"project_id": "01JZ9WV3N8GQ5T2M7K4C6XBARF",
"data": {
"videoId": "01JZ9WV3N8GQ5T2M7K4C6XBARH"
}
}Responses
| Status | Meaning |
|---|---|
200 | Acknowledge the delivery with any 2xx within 10 seconds; non-2xx responses are retried per the Phase 9 schedule. |
Example request
{
"id": "01JZ9WV3N8GQ5T2M7K4C6XBARM",
"type": "video.encoding.ready",
"created_at": "2026-06-11T11:00:00.000Z",
"project_id": "01JZ9WV3N8GQ5T2M7K4C6XBARF",
"data": {
"videoId": "01JZ9WV3N8GQ5T2M7K4C6XBARH"
}
}