| Code | Status | Detail |
|---|---|---|
invalid_idempotency_key | 400 | The idempotency key is invalid. |
invalid_redelivery_target | 400 | The redelivery target is invalid. |
invalid_value | 400 | The information you entered isn’t valid. Please check it and try again. |
unauthenticated | 401 | Authentication is required. |
forbidden | 403 | You do not have permission to perform this action. |
delivery_not_found | 404 | Webhook delivery not found. |
event_not_delivered | 404 | This event was not delivered to the specified webhook. |
webhook_not_found | 404 | Webhook not found. |
already_exists | 409 | The resource already exists. |
conflict | 409 | The request conflicts with the current resource state. |
delegated_authorization_inactive | 409 | The original delegation no longer authorizes this event. |
idempotency_key_conflict | 409 | This idempotency key was already used for a different redelivery request. |
redelivery_in_progress | 409 | A redelivery is already in progress for this event and webhook. |
redelivery_not_eligible | 409 | This event cannot be redelivered in its current state. |
redelivery_window_expired | 409 | This event is outside the redelivery window. |
webhook_endpoint_unavailable | 409 | Enable the webhook endpoint before redelivering this event. |
rate_limited | 429 | Too many requests. Please try again later. |
redelivery_rate_limited | 429 | Too many redeliveries were requested for this webhook. Try again later. |
server_error | 500 | Something went wrong. |
bad_gateway | 502 | We couldn’t complete that request because one of Natural’s services returned an unexpected response. Please try again. |
delegation_authorization_unavailable | 503 | Delegation authorization is temporarily unavailable. Try again later. |
service_unavailable | 503 | The service is temporarily unavailable. |
Resource errors
Webhooks
Public error codes for Webhooks API endpoints
All error responses follow the standard error format.
Validation errors (422) and rate limit errors (429) apply to all endpoints and are documented in the Error Handling guide.