Firework Webhooks

generated: '2026-07-19'
method: searched
source: https://docs.firework.com/firework-for-developers/api/webhooks.md
docs: https://docs.firework.com/firework-for-developers/api/webhooks
type: Webhooks
transport: HTTP POST callbacks (application/json)
provisioning: >-
  Not self-service. Endpoints are configured by the Firework IS team; the
  subscriber supplies a callback URL, desired event types, and business ID and
  receives an endpoint secret used to verify signatures.
signature:
  header: FW-Webhooks-Signature
  algorithm: HMAC-SHA256
  encoding: base64
  format: "t=<unix_ms>,v1=<base64 hmac>"
  signed_payload: "{t}.{raw_request_body}"
delivery:
  method: POST
  content_type: application/json
  timeout_seconds: 30
  success_status_codes: [200, 202, 204]
  retry:
    max_attempts: 6
    backoff:
      - attempts: "1-3"
        interval: 1 hour
      - attempts: "4-6"
        interval: 24 hours
events:
  - type: video_created
    description: Video created — transcoding complete or failed.
  - type: video_updated
    description: Video metadata or state changed after creation.
  - type: video_import_failed
    description: Async URL import failed (download error, validation error).
notes: >-
  Only video-related events are documented on the public webhooks page;
  additional event types (e.g. livestream) may be documented separately.