Reference
email_transient
The send failed for a reason that may clear on its own.
502HTTP 502 · Email Transient
What it means
The send failed for a reason that may clear on its own.
Retry with backoff
Transient. Retry with exponential backoff and jitter, not a fixed interval.
What causes it
- A timeout, a 5xx from the provider, a rate limit, or a connection reset.
How to fix it
- Retry with exponential backoff. The worker already does this for queued sends.
What the response looks like
502 application/problem+json
{
"error": {
"code": "email_transient",
"message": "The send failed for a reason that may clear on its own",
"request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
},
"type": "https://integrable.cloud/docs/errors/email_transient",
"title": "Email Transient",
"status": 502,
"detail": "The send failed for a reason that may clear on its own",
"instance": "/api/bots/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 here wrong or missing? Tell us — the documentation and the API are maintained by the same person, so a correction is a fix rather than a ticket.