DocsEvents & Webhooks
Webhook Retries & Failure Handling
Understand the webhook retry policy, exponential backoff intervals, timeout limits, and failure logging.
4 min read•API v1
Delivery Policy & Timeouts
* **HTTP Timeout**: Webhook requests timeout after **10 seconds**.
* **Success Definition**: Any `2xx` HTTP status code (e.g. `200 OK`, `202 Accepted`) is marked as successful.
* **Retry Schedule**: On non-`2xx` status or network timeout, the BullMQ `developer-webhook-queue` retries **3 times** with exponential backoff:
* Attempt 1: Immediate
* Attempt 2: ~5 seconds
* Attempt 3: ~15 seconds
* Attempt 4: ~45 seconds
* **Failure Isolation**: A webhook delivery failure **never** prevents WhatsApp message delivery, contact persistence, or webhook responses to Meta.
Inspecting Delivery Logs
You can query recent delivery attempts, status codes, and error messages via `GET /api/v1/webhooks/{id}`.