Reference

email_permanent

The send failed for a reason that will not change on a retry.

502HTTP 502 · Email Permanent

What it means

The send failed for a reason that will not change on a retry.

Do not retry

The identical request will fail the same way every time. Change it first.

What causes it

  • The recipient address was rejected.
  • The sending domain is blocked, or the API key is wrong.

How to fix it

  • Correct the address or the sender configuration.
  • Queued sends that hit this go straight to the dead-letter table with the reason attached, rather than burning retries.

What the response looks like

502 application/problem+json
{
  "error": {
    "code": "email_permanent",
    "message": "The send failed for a reason that will not change on a retry",
    "request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
  },
  "type": "https://integrable.cloud/docs/errors/email_permanent",
  "title": "Email Permanent",
  "status": 502,
  "detail": "The send failed for a reason that will not change on a retry",
  "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.

Building on it? Start on the free plan — no card — and call the same API the dashboard uses.

Start free