Errors

Generic error types

not-found

The normal 404 Not Found response code

internal-server-error

A generic “server error” code. Something went wrong, but it wasn’t because of any problem detected in the request.

unavailable

The resource requested is not currently available. May be used in 429 Too Many Requests or 503 Service Unavailable responses.

bad-request

Indicates that there is a problem with the request; usually a validation error on a property or parameter. The error code is 400 Bad Request.

invalid-group

A recipient group was specified, but no such group was found. The error code is 400 Bad Request.

authentication-required

No credentials were provided. The error code is 401 Unauthorized.

authentication-failed

Verification of credentials failed. The error code is 401 Unauthorized.

authorisation-failed

The authenticated principal was denied the requested access to the resource. The error code is 403 Forbidden.

POST /v1/messages

The following types are only applicable to responses from POST /v1/messages.

max-batch-size-exceeded

Request contained an excessive number of messages. Should be used in a 400 Bad Request response

insufficient-credits

Request to submit messages failed because the user does not have enough credits. Should be used in a 403 Forbidden response.

insufficient-quota

Request to submit messages failed because the user does not have enough quota. Should be used in a 403 Forbidden response.