Retries & Delivery
Retries
- 4 attempts total (1 + 3 retries), exponential backoff: 5s, 10s, 20s, 40s. Request timeout is 10s.
- Any non-2xx, network error, or timeout counts as a failure. After all attempts, the delivery is marked
permanently_failed.
Delivery statuses
Delivery status | Meaning |
|---|---|
pending | Queued / retrying. |
delivered | A 2xx was received. |
failed | Last attempt failed; retries pending. |
permanently_failed | All retries exhausted; no further attempts. |
Inspect the delivery log via GET /partner/webhooks/:id/deliveries (see Webhook Management).
Endpoint requirements
- HTTPS only (plain HTTP is rejected at create time).
- Respond fast (<2s) and return 2xx on success.
- Verify the signature before acting (see Verifying Signatures).
- Be idempotent — dedupe on the envelope
idorX-Qwik-Delivery-Id.