email_failed
An email could not be sent.
502HTTP 502 · Email Failed
What it means#
An email could not be sent.
Retry with backoff
Transient. Retry with exponential backoff and jitter, not a fixed interval.
What causes it#
- The email provider returned an error or was unreachable.
How to fix it#
- Retry with backoff.
- Check whether the more specific `email_transient` or `email_permanent` is present — they say whether retrying is worth anything.
What the response looks like#
502 application/problem+json
{
"error": {
"code": "email_failed",
"message": "An email could not be sent",
"request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
},
"type": "https://integrable.cloud/docs/errors/email_failed",
"title": "Email Failed",
"status": 502,
"detail": "An email could not be sent",
"instance": "/api/agents/01a0652b-3713-7ea1-a6c9-2e895389ec34"
}Branch on error.code, not on the message — the code is stable, the sentence is not. Log request_id either way.
Still stuck#
Quote the request_id from the response — hello@integrable.cloud. It is what lets us find the exact request. The full list of codes is at Error codes, and the conventions every endpoint shares are in Retries, versioning and limits.
Something unclear or missing? Tell us and we’ll fix it.