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
| Event | Sent when |
|---|---|
job.completed | A job finished and the tracks are ready. |
job.failed | A job failed. The body has the error code. |
balance.low | The 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.