> ## 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 template not approved

> The message wasn't delivered because its template is pending review, was rejected, isn't ready to send yet, or can't be sent from your sender.

**Error code:** `TEMPLATE_NOT_APPROVED`

**Should you try again?** Yes, after Meta approves the template and WhatsApp finishes preparing it. If `subcode` is `TEMPLATE_NOT_ELIGIBLE`, contact support first.

## Why it happens

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

| `subcode` | `action` | Cause |
| - | - | - |
| `TEMPLATE_NOT_ELIGIBLE` | `contact_support` | WhatsApp can't send this template from your sender. |

If `subcode` is `null`, the template isn't approved or isn't ready yet, and `action` is `fix_and_resend`.

Wavix reports `TEMPLATE_NOT_ELIGIBLE` at once and doesn't retry the message.

## How to fix it

For `TEMPLATE_NOT_ELIGIBLE`, contact [support@wavix.com](mailto:support@wavix.com). Include the message ID (`uuid`, or `message_uuid` in the event), the sender number, and the template name.

If `subcode` is `null`:

1. Check the template's `status`:

   ```bash theme={null}
   curl "https://api.wavix.com/v1/whatsapp/templates" \
     -H "Authorization: Bearer your_api_key"
   ```
2. If it's pending, wait for the review. Most templates are reviewed within minutes, and some take up to 48 hours.
3. If it was rejected, change the content and submit it again as a new template.
4. If it's `approved`, wait a few minutes. WhatsApp may still be preparing the template.
5. Send the message again as a new request with a new `idempotency_key`.

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

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

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.