Error Codes
All the information about the API error codes
Whenever the Mailazy API detects an input error it will return an HTTP error status code along with a JSON object containing error details, Here you will find additional information about what to expect if you don’t format your request properly, or we fail to properly process your request.
Response Codes
Status Code | Description |
---|---|
200 | Email queued successfully |
400 | Unprocessable request, this could be malformed JSON or incorrect fields. In this case, the response body contains JSON with an API error code and message containing details on what went wrong |
401 | Unauthorized, Missing or incorrect access key in header |
429 | Too many requests/Rate limit exceeded |
500 | Internal Server Error, indicates an issue with Mailazy's servers processing your request |
Error Codes
A JSON object containing error details along with error code and staus code:
{
"error": "err",
"message": "details",
"error_code": 100
}
The error_code
field can be used to programmatically detect the type of error. Here are the supported error codes:
Error Code | Error | Message |
---|---|---|
100 | Authentication Failure | Your request did not contain the correct Access Key and Secret in the header. |
200 | Malformed Request | Validation failed for the email request JSON data that you provided. |
201 | JSON required | Your HTTP request does not have the Accept and Content-Type headers set to application/json. |
202 | Invalid Recipient Address | Validation failed for the recipient email address JSON data that you provided. |
203 | Invalid From Mail Address | Validation failed for the from email address JSON data that you provided. |
204 | The from address does not match a verified Sender Identity | You’re trying to send email with a From address that does not have a sender identity verified with Mailazy. |
205 | Invalid Mail Content | Validation failed for the content data that you provided. |
206 | Invalid gmail recipient address | Validation failed for the gmail recipient email address that you provided, a valid gmail address should be 6–30 characters long. |
300 | Daily Limit Reached | You have exceeded the daily limit, please reduce the concurrency and request rate of your requests. If your app requires a rate limit increase, please contact support to request it. |
301 | Too many request | You have reached a limit to send emails in a short period, Please wait for some time or contact us. |
401 | Permission to send email does not exist | The account that is associated with the send request is not approved for sending. |
401 | Internal Server Error | An unknown error occurred during the execution, please contact support to resolve it. |