API Response Codes
All of Mailgun's HTTP response codes follow standard HTTP definitions. For some additional information and troubleshooting steps, please see below.
Response Code | Description |
---|---|
400 | Will typically contain a JSON response with a "message" key which contains a human readable message / action to interpret. |
403 | Auth error or access denied. Please ensure your API key is correct and that you are part of a group that has access to the desired resource. |
404 | Resource not found. NOTE: this one can be temporal as our system is an eventually-consistent system but requires diligence. If a JSON response is missing for a 404 - that's usually a sign that there was a mistake in the API request, such as a non-existing endpoint. |
429 | Mailgun does have rate limits in place to protect our system. Please retry these requests as defined in the response. In the unlikely case you encounter them and need them raised, please reach out to our support team. |
500 | Internal Error on the Mailgun side. Retries are recommended with exponential or logarithmic retry intervals. If the issue persists, please reach out to our support team. |