Developers · Preview documentation

Webhooks.

Get signed events when runs complete or fail, and verify each one before you trust it. Preview documentation.

Webhooks / Webhook events

Webhooks

Webhook events

Signed events that report the lifecycle of runs and connections.

run.startedeventA run began processing.
run.completedeventA run finished and every record was delivered.
run.failedeventA run finished with one or more failed records.
connection.unhealthyeventA health check for a connection failed.
run.failedIllustrative
POST https://your-app.example/hooks/nextra
X-Nextra-Signature: t=1760000000,v1=9b1c…e4
Content-Type: application/json

{
  "type": "run.failed",
  "run_id": "run_8f3jz",
  "error": { "field": "mobile", "message": "Destination rejected the mobile number format.", "expected": "E.164" }
}

Respond with any 2xx status within 10 seconds. Non-2xx responses are retried with exponential backoff.