> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wavix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp sender rate limited

> The message wasn't delivered because the low quality rating of your sender limits how many recipients it can reach.

**Error code:** `SENDER_RATE_LIMITED`

**Should you try again?** Yes, later. Send fewer messages from this sender in the meantime.

## Why it happens

The `subcode` field gives the cause, and `action` says what to do:

| `subcode` | `action` | Cause |
| - | - | - |
| `LOW_QUALITY_RATING` | `resend_later` | The quality rating of your sender limits how many recipients it can reach. |

If `subcode` is `null`, `action` is `resend_later`.

If WhatsApp keeps slowing down your sender until Wavix stops retrying, you get [Message expired](https://docs.wavix.com/errors/message-expired) instead.

## How to fix it

1. Send fewer messages from this sender for a while. Send the message again later, as a new request with a new `idempotency_key`.
2. Check the sender's quality rating:

   ```bash theme={null}
   curl "https://api.wavix.com/v1/whatsapp/senders" \
     -H "Authorization: Bearer your_api_key"
   ```
3. Send messages only to recipients who opted in, and make sure they expect them.

For more information, see [Quality rating](https://docs.wavix.com/messaging/whatsapp/concepts.md#quality-rating).

## Technical details

| Detail | Value |
| - | - |
| Returned in | The `whatsapp.message.failed` event, in `data.error`, and the `error` field of [Retrieve a WhatsApp message](https://docs.wavix.com/api-reference/whatsapp/retrieve-a-whatsapp-message.md) and [List WhatsApp messages](https://docs.wavix.com/api-reference/whatsapp/list-whatsapp-messages.md). The request that sent the message succeeded. |
| `code` | `SENDER_RATE_LIMITED` |
| `subcode` | A value from [Why it happens](#why-it-happens), or `null` |
| `action` | `resend_later` |

For the error format and how to handle it, see [WhatsApp delivery errors](https://docs.wavix.com/messaging/whatsapp/troubleshooting.md#how-delivery-errors-reach-you).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.