VideohatiDocs
API referenceWebhooks

Webhook event delivery

Webhook event delivery

POSTyour registered webhook endpoint

This 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

StatusMeaning
200Acknowledge 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"
  }
}