Statuses & error codes
Below is a reference of Hookdeck's internal event statuses and error codes, as well as some common HTTP status codes.
Hookdeck event status
Event Status | Description |
---|---|
Pending | The event is pending delivery |
Failed | The most recent delivery attempt received an HTTP status code in the failure range |
Successful | The most recent delivery attempt received an HTTP status code in the success range |
On hold | Delivery will be attempted when the associated connection is unpaused |
Hookdeck error codes
If your destination was unreachable or failed to respond, the event will appear in the dashboard with an ERR
flag. A more specific error code can be found by inspecting the event.
Hookdeck Error Code | Explanation |
---|---|
CONNECTION_REFUSED | The request to your destination could not be made because the connection was refused. |
CONNECTION_RESET | The request to your destination could not be made because the connection was forcibly closed by your server. |
NOT_FOUND | The request to your destination could not be made because the domain or host was not found or unavailable. |
TIMEOUT | The request to your destination exceeded the 60-second timeout window. The request might have still been processed by your destination. |
MISSING_URL | Your destination does not have a HTTP URL configured. It can only receive attempts on the CLI. |
CLI | The attempt failed to be forwarded to your local server by the CLI. Check your console for more details. |
SELF_SIGNED_CERT | Your destination uses a self-signed SSL certificate. Hookdeck only supports valid, verifiable certificates. |
ERR_TLS_CERT_ALTNAME_INVALID | Your destination's SSL certificate is not valid. |
ERR_SSL_WRONG_VERSION_NUMBER | Indicates a mismatch between the SSL/TLS version expected by your destination and the version supported by the server. |
SSL_CERT_EXPIRED | Your destination's SSL certificate is expired. |
SSL_ERROR_CA_UNKNOWN | The intermediate certificate / CA Bundle is invalid or mismatched. |
UNKNOWN | An uncategorized error occurred. If one of these errors is triggered, Hookdeck's technical team is notified and will investigate. |
HTTP response status codes
When your destination responds with a valid HTTP response code, it will be displayed as the event's status. A response code between 200 and 299 is considered successful. A response code of 400 or above is considered a failure.
Status Code | Description | Explanation |
---|---|---|
200 | Good Request | Your request is valid. |
400 | Bad Request | Your request is invalid and could not be understood. |
401 | Unauthorized | Your API key is wrong. |
403 | Forbidden | Access to the requested resource is restricted. |
404 | Not Found | The resource could not be found. |
413 | Payload Too Large | The payload size exceeds the limit. |
422 | Unprocessable Entry | The request was understood but contains invalid input. |
429 | Too Many Requests | The request limit for a specific time period has been exceeded. |
500 | Internal Server Error | There was a problem with the server. Try again later. |
503 | Service Unavailable | The server is temporarily offline for maintenance. Try again later. |