Skip to content
AVFlow
Console

Webhooks

Setup

Section titled “Setup”
  1. Open AVFlow Console → Webhooks
  2. Add your HTTPS endpoint URL
  3. Save the signing secret

Delivery

Section titled “Delivery”

AVFlow POSTs JSON to your URL when events occur. Respond with 2xx to acknowledge.

Verify signatures

Section titled “Verify signatures”

Check the X-AVFlow-Signature header (HMAC-SHA256 of the raw body with your webhook secret). Reject requests that fail verification.

Retry policy

Section titled “Retry policy”

Failed deliveries are retried with exponential backoff. Design your handler to be idempotent — the same eventId may arrive more than once.

Payload example — job completed

Section titled “Payload example — job completed”
{
  "version": "avflow.events.v1",
  "eventType": "job.completed",
  "eventTime": "2026-06-10T13:00:00Z",
  "job": {
    "id": "job_abc123",
    "name": "live-show",
    "status": "completed"
  },
  "payload": {
    "reason": "deleted"
  }
}

Use job.completed and job.failed to update your database or notify users. Use Console Usage for cost details.