fal.ai

Set up the webhook in fal.ai

1. Submit the queue request with webhook_url set to this Hooks receive URL; fal calls it only for the final OK or ERROR result.
2. fal signs with Ed25519 keys published at https://rest.fal.ai/.well-known/jwks.json; Hooks caches keys for at most one hour and never trusts a URL supplied with the request.
3. Set the Hooks source secret to your fal user id (the value fal sends in X-Fal-Webhook-User-Id) so deliveries are bound to your account.
4. fal does not follow redirects (3xx is a permanent failure) and retries with backoff; result storage expires, so treat every delivery idempotently.

Signature verification

Events Hooks normalizes

Normalized payload

Every adapter produces this shape before filters or templates run. The raw payload and sanitized headers stay attached for audit, but filters and templates read the normalized fields.

{
  "id": "evt_demo",
  "source": "fal",
  "type": "request.completed",
  "action": "completed",
  "deliveryId": "delivery_demo",
  "subject": {
    "title": "fal.ai event"
  },
  "raw": {
    "request_id": "req_8f3c2a1d6e4b9f0a",
    "gateway_request_id": "gw_2b7d9e4c1a3f8b60",
    "status": "OK",
    "payload": {
      "images": [
        {
          "url": "https://fal.media/files/example.png",
          "content_type": "image/png",
          "file_name": "example.png",
          "file_size": 184320,
          "width": 1024,
          "height": 1024
        }
      ],
      "seed": 42
    }
  }
}

Filter and template examples

type equals "request.completed"

"fal.ai event: {{event.subject.title}}"

Retries and the delivery log

408, 425, 429, and 5xx responses retry with backoff and honor Retry-After; other 4xx responses fail permanently with a named code. Every attempt keeps the rendered request and the target response, so a failure points at one field or one status instead of a guess.

Common errors

Pair with a target

Reference

• Receiving eventshttps://fal.ai/docs/documentation/model-apis/inference/webhooks
• Verify signatureshttps://hooks.events/docs/signatures.md
• Payload templateshttps://hooks.events/docs/templates.md

Other sources

AirtableAirtable webhooks notify you when records in a watched table change; the changed records are fetched separately from the webhook payloads API.AsanaAsana webhooks cover task, project, section, story, team and goal changes, established by a one-time X-Hook-Secret handshake.Auth0Auth0 custom log streams POST tenant log events (login, signup, logout, token exchange, user changes) to a webhook.AWS SNSAWS SNS delivers JSON notifications and subscription confirmations to HTTP(S) endpoints, signed with an RSA certificate published under an sns.<region>.amazonaws.com URL.Azure DevOpsAzure DevOps service hooks send git pushes, pull requests, work items, builds and releases to a public webhook endpoint.BitbucketBitbucket Cloud repository webhooks cover pushes, pull request changes, and issue events.BrowserbaseBrowserbase Functions webhooks report invocation and build lifecycle states (pending, running, completed, failed).Cal.comCal.com booking webhooks wrap the booking in a triggerEvent envelope and sign each delivery with an HMAC-SHA256 of the raw body.Browse all sourcesSetup steps, signatures, events, and payload samples for every provider.