Hookdeck
Events & attempts overviewView eventsInspect an eventCustom event viewsStatuses & error codes

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 StatusDescription
PendingThe event is pending delivery
FailedThe most recent delivery attempt received an HTTP status code in the failure range
SuccessfulThe most recent delivery attempt received an HTTP status code in the success range
On holdDelivery 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 CodeExplanation
CONNECTION_REFUSEDThe request to your destination could not be made because the connection was refused.
CONNECTION_RESETThe request to your destination could not be made because the connection was forcibly closed by your server.
NOT_FOUNDThe request to your destination could not be made because the domain or host was not found or unavailable.
TIMEOUTThe request to your destination exceeded the 60-second timeout window. The request might have still been processed by your destination.
MISSING_URLYour destination does not have a HTTP URL configured. It can only receive attempts on the CLI.
CLIThe attempt failed to be forwarded to your local server by the CLI. Check your console for more details.
SELF_SIGNED_CERTYour destination uses a self-signed SSL certificate. Hookdeck only supports valid, verifiable certificates.
ERR_TLS_CERT_ALTNAME_INVALIDYour destination's SSL certificate is not valid.
ERR_SSL_WRONG_VERSION_NUMBERIndicates a mismatch between the SSL/TLS version expected by your destination and the version supported by the server.
SSL_CERT_EXPIREDYour destination's SSL certificate is expired.
SSL_ERROR_CA_UNKNOWNThe intermediate certificate / CA Bundle is invalid or mismatched.
UNKNOWNAn 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 CodeDescriptionExplanation
200Good RequestYour request is valid.
400Bad RequestYour request is invalid and could not be understood.
401UnauthorizedYour API key is wrong.
403ForbiddenAccess to the requested resource is restricted.
404Not FoundThe resource could not be found.
413Payload Too LargeThe payload size exceeds the limit.
422Unprocessable EntryThe request was understood but contains invalid input.
429Too Many RequestsThe request limit for a specific time period has been exceeded.
500Internal Server ErrorThere was a problem with the server. Try again later.
503Service UnavailableThe server is temporarily offline for maintenance. Try again later.