Skip to main content
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: 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.

Technical details

For the error format and how to handle it, see WhatsApp delivery errors.