Skip to Content
CallMitraDocs
Errors

whatsapp_upstream_throttled

WhatsApp is limiting messages from this number right now.

HTTP statusTypeCode
429rate_limit_errorwhatsapp_upstream_throttled

What it means

WhatsApp refused the message because of a sending limit and nothing was delivered. Wait for the number of seconds in the Retry-After header and retry with the same Idempotency-Key.

How to handle it

Wait for the number of seconds in the Retry-After header, then retry with exponential backoff and jitter. Spread bulk work over time.

Example response

{
  "detail": "WhatsApp is limiting messages from this number right now.",
  "error": {
    "type": "rate_limit_error",
    "code": "whatsapp_upstream_throttled",
    "message": "WhatsApp is limiting messages from this number right now.",
    "param": null,
    "docUrl": "https://docs.callmitra.ai/errors/whatsapp_upstream_throttled",
    "requestId": "req_3f9c2a7d1b8e4c6a9f0e2d4b6a8c0e1f"
  }
}

Branch on error.code; it never changes once published. The message text can change. See Errors for the envelope.

Returned by

  • POST /api/v1/whatsapp/messages — Send a WhatsApp message

On this page