Response Status Codes
Your endpoint must respond with a 2xx status code to acknowledge receipt. Any other response triggers a retry.
| Status Code | Behavior |
|---|---|
| 200-299 (2xx) | Success — delivery marked as delivered, no retry |
| 400-499 (4xx) | Client error — delivery marked as failed, retried per retry policy |
| 500-599 (5xx) | Server error — delivery marked as failed, retried per retry policy |
| Timeout (>10s) | No response within 10 seconds — treated as failure, retried |
| Connection refused | Endpoint unreachable — treated as failure, retried |
Tip
Return 200 OK immediately and process the event asynchronously (e.g., using a queue). This ensures your endpoint responds within the 10-second window even for slow processing tasks.