Response Codes
SMTP2GO uses conventional HTTP response codes to indicate the success or failure of a request.
In general, codes in the 2xx
range indicate success. Codes in the 4xx
range indicate an error and reasons the request may have failed are given in the information provided. Codes in the 5xx
range indicate an error with SMTP2GO's servers (these are rare and if encountered please contact support for assistance).
Below is a list of status codes and their corresponding definitions:
Status Codes
Status Code | Definition |
---|---|
200 - OK | Everything worked as expected. |
400 - Bad Request | The request was unacceptable, often due to missing a required parameter. |
401 - Unauthorized | No valid API key was provided. |
402 - Request Failed | The parameters were valid but the request failed. |
403 - Forbidden | The API key doesn't have permission to perform the request. |
404 - Not Found | The requested resource doesn't exist. |
429 - Too Many Requests | Too many requests hit the API too quickly. We recommend an exponential backoff of your requests. |
500 , 502 , 503 , 504 - Server Errors | Something went wrong on SMTP2GO's end (these are rare). |
Additional information is contained in the response body, as in the following examples
{
"error": "Failed to remove the single sender email - An error occurred deleting sender email [email protected] or it doesn't exist",
"error_code": "E_ApiResponseCodes.API_EXCEPTION"
}
Error Codes
Some errors contain additional field validation error information, as below.
{
"error": "An error occurred processing the json data you sent with the request, please make sure the data conforms to the specification for this call (see the documentation here: https://apidoc.smtp2go.com/documentation/#/README) and try again. Don't forget to set Content-Type to 'application/json'.",
"error_code": "E_ApiResponseCodes.NON_VALIDATING_IN_PAYLOAD",
"field_validation_errors": {
"fieldname": "sender",
"message": "The field 'sender' was expecting a valid RFC-822 formatted email field but found 'robs_invalid.com', Please correct your JSON payload and try again."
}
}
For more detailed explanations of common Error Codes when sending, try our Common Sending Errors knowledgebase article or reach out to our support team for assistance.
Updated 5 months ago