Reference

notification_failed

A notification — WhatsApp, Telegram, Slack — could not be delivered.

502HTTP 502 · Notification Failed

What it means

A notification — WhatsApp, Telegram, Slack — could not be delivered.

Retry with backoff

Transient. Retry with exponential backoff and jitter, not a fixed interval.

What causes it

  • The channel provider returned an error or was unreachable.

How to fix it

  • Retry with backoff, or read the more specific variant if one is present.

What the response looks like

502 application/problem+json
{
  "error": {
    "code": "notification_failed",
    "message": "A notification — WhatsApp, Telegram, Slack — could not be delivered",
    "request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
  },
  "type": "https://integrable.cloud/docs/errors/notification_failed",
  "title": "Notification Failed",
  "status": 502,
  "detail": "A notification — WhatsApp, Telegram, Slack — could not be delivered",
  "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