Skip to main content

How webhooks work

Register an HTTPS endpoint and Framelane will POST a signed JSON payload whenever a job event occurs.
Each webhook delivery is a new HTTP POST with a signed body. Your endpoint must respond with 2xx within 10 seconds or the delivery is marked failed and queued for retry.

Registering a webhook

Response — includes your workspace signing secret:
Store the secret securely — it’s used to verify signatures. This is your workspace-level signing secret, so the same value is returned for every webhook you create, and rotating it re-keys them all.

Per-request webhooks

You can override workspace webhooks for a single job by including webhook_url in the request body:

Endpoints