> ## 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 limit reached

> The message wasn't delivered because your sender reached its messaging limit: the number of people it can start conversations with in a rolling 24-hour period.

**Error code:** `SENDER_LIMIT_REACHED`

**Should you try again?** Yes, later. For `UNIQUE_RECIPIENTS_LIMIT`, after the 24-hour period resets.

## Why it happens

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

| `subcode` | `action` | Cause |
| - | - | - |
| `UNIQUE_RECIPIENTS_LIMIT` | `resend_later` | Your sender reached the number of recipients it can message in 24 hours. |
| `RECIPIENT_MESSAGE_LIMIT` | `resend_later` | Your sender reached the number of messages it can send to this recipient. |

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

## How to fix it

* `UNIQUE_RECIPIENTS_LIMIT`, other subcodes, or `null`:
  1. Send the message again after the 24-hour period resets, as a new request with a new `idempotency_key`. While the limit applies, the sender's `status` is `restricted`, and the `whatsapp.sender.connected` event tells you when the restriction ends.
  2. Replies inside the customer service window don't count toward the limit, so recipients who message you first can still get replies.
  3. To raise the limit, keep your quality rating high. WhatsApp raises the limit as you send more high-quality messages.
* `RECIPIENT_MESSAGE_LIMIT`: Stop sending to this recipient for now. Send the message again later, as a new request with a new `idempotency_key`.

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

## 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_LIMIT_REACHED` |
| `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.