Webhooks let your server react to render lifecycle events without polling.
Event types
Per-render webhooks
Pass webhook_url in the render payload:
Imtegrate POSTs to that URL once the render is completed or failed.
Org-level webhooks
In Settings → Webhooks, register an endpoint that receives all events for the organization. Useful when you don’t control the request (e.g., dashboard-triggered renders).
Payload
Signature verification
Each request includes an X-Imtegrate-Signature header — HMAC-SHA256 of the raw body, keyed by the webhook secret shown at creation time.
Always verify the signature before trusting the payload. Reject any request whose signature doesn’t match.
Retries
Failed deliveries (non-2xx response or timeout) are retried with exponential backoff: 1 min, 5 min, 30 min, 2 h, 12 h. After 5 failed attempts the event is dropped and surfaced in the dashboard.
Idempotency
Each delivery includes X-Imtegrate-Delivery-Id. Treat it as an idempotency key on your side — the same event may be delivered more than once.