MANIFESTRO DOCS
Console
Guides

Webhooks

Get an HTTP request when a job finishes or the balance runs low, instead of polling.

Add an endpoint in Organization Settings → Webhooks and choose the events. We send a POST with a JSON body and expect a 2xx response within 10 seconds.

Events

EventSent when
job.completedA job finished and the tracks are ready.
job.failedA job failed. The body has the error code.
balance.lowThe balance dropped below the notification threshold.

Verify the signature

Every request carries Manifestro-Signature: t=<unix seconds>,v1=<signature>. The signature is a hex HMAC-SHA256 of <t>.<raw body> with your endpoint's signing secret. Compare it in constant time, and reject requests whose t is old.

Retries

Answer 2xx within 10 seconds. A failed delivery is retried 5 times (after 30 s, 2 min, 10 min, 1 h and 6 h). The event id is the same on every retry — de-duplicate on it.

Verify a webhook
# Example payload
{
  "id": "evt_4Kd82…",
  "type": "job.completed",
  "created_at": "2026-11-16T09:12:58Z",
  "data": { "job_id": "job_8f3k2m9x1q7w5e4r2t" }
}