> ## 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 unavailable

> The message wasn't delivered because your sender can't send messages: it isn't registered, or it's banned or disconnected.

**Error code:** `SENDER_UNAVAILABLE`

**Should you try again?** No, not from this sender until it can send messages again.

## Why it happens

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

| `subcode` | `action` | Cause |
| - | - | - |
| `SENDER_NOT_REGISTERED` | `contact_support` | Your sender isn't registered on WhatsApp. |
| `SENDER_RESTRICTED` | `contact_support` | WhatsApp restricted what your sender can do. |
| `SENDER_MISCONFIGURED` | `contact_support` | Your sender's setup doesn't allow this message. |

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

## How to fix it

1. Check the sender's `status`:

   ```bash theme={null}
   curl "https://api.wavix.com/v1/whatsapp/senders" \
     -H "Authorization: Bearer your_api_key"
   ```
2. Send the message from another sender whose `status` is `connected`, as a new request with a new `idempotency_key`.
3. To restore the sender, contact [support@wavix.com](mailto:support@wavix.com). Include the message ID (`uuid`, or `message_uuid` in the event), the sender number, and the `subcode`.

## 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_UNAVAILABLE` |
| `subcode` | A value from [Why it happens](#why-it-happens), or `null` |
| `action` | `contact_support` |

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.