---
title: "FAL provider webhook"
method: POST
path: "/v1/providers/webhooks/fal"
tags: ["Providers"]
---

# FAL provider webhook

`POST /v1/providers/webhooks/fal`

## Request

- Base URL: `https://api.lizzflix.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lizzflix.xyz/v1/providers/webhooks/fal`
- Auth: none declared

Receives provider-side job status notifications from FAL. Payload shape varies by event; the handler extracts `request_id` to correlate with a generation job.

## Request body

- ProviderWebhookPayload

## Response `200`

Webhook accepted

- ProviderWebhookResponse
  - `ok` boolean, required
  - `skipped` boolean
  - `jobId` string

## Other responses

- `400`: Bad request
- `401`: Signature check failed (FAL_WEBHOOK_VERIFY enforce)

---

[API](https://skmtc.dev/lizzflix/apis/lizzflix-api.md) · [All operations](https://skmtc.dev/lizzflix/apis/lizzflix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lizzflix/apis/lizzflix-api/revisions/4536ce9d80ff?raw)