Webhooks

Why webhooks

Renders are async (2-4 min). Instead of polling GET /jobs/{id}, register a webhook and Reeloop POSTs the result to your endpoint.

Events

• render.completed - the video is ready; payload includes videoUrl.
• render.failed - the render failed; credits are refunded automatically.

Payload

{
  "type": "render.completed",
  "jobId": "7c9e2a1d-…",
  "videoUrl": "https://…/media/….mp4",
  "durationSeconds": 30,
  "deliveredAt": "2026-08-04T12:00:00Z"
}

Verifying

Each delivery is signed with your webhook secret. Verify the signature before trusting the payload, and respond with a 2xx quickly - retries back off on non-2xx.