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

# Recipient isn't on WhatsApp

> The message wasn't delivered because the recipient's number isn't on WhatsApp or can't receive messages.

**Error code:** `RECIPIENT_NOT_ON_WHATSAPP`

**Should you try again?** No. Sending it again to this number fails the same way. If `subcode` is `APP_UPDATE_REQUIRED`, send it again after the recipient updates WhatsApp or accepts the WhatsApp Terms of Service.

## Why it happens

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

| `subcode` | `action` | Cause |
| - | - | - |
| `NOT_REGISTERED` | `do_not_resend` | The number isn't registered on WhatsApp. |
| `APP_UPDATE_REQUIRED` | `resend_later` | The recipient's WhatsApp app can't show the message. The recipient may need to update the app or accept the WhatsApp Terms of Service. |
| `DEVICE_UNSUPPORTED` | `do_not_resend` | The recipient's device doesn't support the message. |
| `BLOCKED_BY_OPERATOR` | `do_not_resend` | This number can't receive WhatsApp messages from businesses. |

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

## How to fix it

1. Check that the number is correct and in E.164 format, such as `+14155550123`.
2. For `APP_UPDATE_REQUIRED`, ask the recipient to update the WhatsApp app or accept the WhatsApp Terms of Service. Then send the message again as a new request with a new `idempotency_key`.
3. Otherwise, reach the recipient on another channel, such as [SMS](https://docs.wavix.com/messaging/send-sms.md).

## 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` | `RECIPIENT_NOT_ON_WHATSAPP` |
| `subcode` | A value from [Why it happens](#why-it-happens), or `null` |
| `action` | `do_not_resend`, or `resend_later` for `APP_UPDATE_REQUIRED` |

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.