Skip to main content
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.