> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skyfree.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Error Code Reference

> What each WhatsApp error code means and whether to retry.

## What is this?

When a WhatsApp message fails, the red **Failed** mark shows an **Error Code**. This table explains the codes the platform knows, in plain words, and whether retrying can help. Codes from `200` to `299` are all permission errors.

## What can I do here?

* Look up a code and see what it means
* Know whether to retry or fix the cause first

## How to use it

Find the code from the failed message (click the red **Failed** mark). **Temporary** means it may work later — wait a few minutes and retry. **Permanent** means retrying won't help; fix the cause first.

The platform also records three failures of its own, which never reach WhatsApp:

| Code | What it means | What to do |
| - | - | - |
| `INVALID_COUNTRY_CODE` | The phone has no valid country code | [Fix the number](https://docs.skyfree.io/troubleshoot/whatsapp/invalid-country-code.md) |
| `WALLET_EXHAUSTED` | A credit line number has no wallet balance | Recharge your wallet in [Transactions](https://docs.skyfree.io/workspace/transactions.md) |
| `CREDIT_LINE_NOT_ATTACHED` | A credit line number's credit line isn't attached yet | **Channels → WhatsApp → Retry** — [WhatsApp channel](https://docs.skyfree.io/workspace/channels/whatsapp.md#how-the-channel-is-billed) |

WhatsApp's own codes:

| Code | What it means | Retry? | What to do |
| - | - | - | - |
| `0` | Could not authenticate the app user (access token expired or invalid) | No | Reconnect, or paste a new access token in Settings |
| `1` | Invalid request or temporary server error | Yes, later | — |
| `2` | Service temporarily unavailable or overloaded | Yes, later | — |
| `3` | Capability or permissions issue | No | Reconnect and approve every permission |
| `4` | App reached its API call rate limit | Yes, later | — |
| `10` | Permission not granted or removed | No | Reconnect and approve every permission |
| `33` | The business phone number has been deleted | No | — |
| `100` | Invalid or unsupported parameter | No | — |
| `190` | Access token has expired | No | Reconnect, or paste a new access token in Settings |
| `200` | No access token provided / permission not granted | No | — |
| `368` | WhatsApp Business Account restricted or disabled for a policy violation | No | Check Meta's business support page |
| `80007` | WhatsApp Business Account reached its rate limit | Yes, later | — |
| `130000` | Generic infrastructure error | Yes, later | — |
| `130403` | The business has blocked this recipient | No | Unblock the contact |
| `130429` | Cloud API message throughput reached | Yes, later | Slow down and retry |
| `130472` | Message was not sent as part of an experiment | No | — |
| `130497` | WhatsApp Business Account is restricted from messaging users in certain countries | No | — |
| `131000` | Message failed to send due to an unknown error | Yes, later | — |
| `131005` | Permission not granted or removed | No | — |
| `131008` | Required parameter is missing | No | — |
| `131009` | One or more parameter values are invalid | No | — |
| `131016` | A service is temporarily unavailable | Yes, later | — |
| `131021` | Sender and recipient phone number are the same | No | Use the customer's number, not your own |
| `131026` | Message undeliverable (not a WhatsApp number, terms not accepted, or old WhatsApp version) | No | Check the number is on WhatsApp — retrying won't help |
| `131031` | Account restricted or disabled, or request data could not be verified | No | Check Meta's business support page |
| `131037` | The business phone number has no approved display name | No | — |
| `131042` | Payment method problem (no credit line, over the limit, or billing not set up) | No | Add a payment method in Meta billing |
| `131045` | Phone number registration error: register the number first | No | Use Register Phone |
| `131047` | More than 24 hours since the recipient last replied: a template message is required | No | Send an approved template, or wait for the customer to message you |
| `131048` | Restrictions on messages from this number (spam or blocked-message rate) | Yes, later | Wait; send fewer messages that customers report |
| `131049` | Not delivered to keep ecosystem engagement healthy (per-user marketing limit) | No | Wait; send fewer marketing messages |
| `131050` | Recipient opted out of marketing messages from this business | No | Don't send marketing to this customer |
| `131051` | Unsupported message type | No | — |
| `131052` | Unable to download the media sent by the user | No | — |
| `131053` | Unable to upload the media used in the message | No | — |
| `131055` | Method not allowed: only marketing template messages are supported | No | — |
| `131056` | Too many messages from this number to the same recipient in a short time | Yes, later | Wait before messaging the same person again |
| `131057` | Business account is in maintenance mode | Yes, later | — |
| `131063` | Marketing templates are disabled for this Cloud API configuration | No | — |
| `131064` | Messaging limit reached due to template classification violations | Yes, later | — |
| `132000` | Number of variable parameters does not match the template | No | Fill in every variable |
| `132001` | Template does not exist in this language or is not approved | No | Use an approved template in the right language |
| `132005` | Translated text is too long | No | — |
| `132007` | Template content violates a WhatsApp policy | No | — |
| `132012` | Variable parameter values are formatted incorrectly | No | Use plain text values |
| `132015` | Template is paused due to low quality | No | — |
| `132016` | Template permanently disabled after repeated low-quality pauses | No | — |
| `132018` | There is an issue with the parameters in the template | No | — |
| `132068` | Flow is in a blocked state | No | — |
| `132069` | Flow is throttled (10 messages in the last hour) | Yes, later | — |
| `133000` | A previous deregistration attempt failed | No | — |
| `133004` | Server is temporarily unavailable | Yes, later | — |
| `133005` | Two-step verification PIN is incorrect | No | — |
| `133006` | Phone number must be verified before registering | No | — |
| `133008` | Too many two-step verification PIN guesses | Yes, later | — |
| `133009` | Two-step verification PIN entered too quickly | Yes, later | — |
| `133010` | Phone number is not registered on the WhatsApp Business Platform | No | Use Register Phone |
| `133015` | The phone number was recently deleted; wait 5 minutes | Yes, later | — |
| `133016` | Too many registration or deregistration attempts for this phone number | Yes, later | — |
| `134011` | WhatsApp Payments terms of service haven't been accepted yet | No | — |
| `134100` | Only marketing templates are supported on this API | No | — |
| `134101` | Template is still syncing; wait up to 10 minutes | Yes, later | — |
| `134102` | Template unavailable for use (check Marketing Messages API eligibility) | No | — |
| `135000` | Unknown error with the request parameters | No | — |
| `200005` | Template insights unavailable for this account | No | — |
| `200006` | Template insights cannot be disabled once enabled | No | — |
| `200007` | Template insights are not enabled for this account | No | — |
| `1752041` | Duplicate onboarding request | No | — |
| `2388012` | This phone number already exists in the account | No | — |
| `2388019` | Message template limit exceeded | No | — |
| `2388039` | Message template status can't be changed | No | — |
| `2388040` | Template field exceeds the character limit | No | — |
| `2388047` | Message header format is incorrect | No | — |
| `2388072` | Message body format is incorrect | No | — |
| `2388073` | Message footer format is incorrect | No | — |
| `2388091` | Phone number is not eligible for a registration code | No | — |
| `2388093` | Phone number is not eligible to verify a registration code | No | — |
| `2388103` | Phone number migration failed | No | — |
| `2388293` | Template has too many variables for its length | No | — |
| `2388299` | Leading or trailing parameters are not allowed | No | — |
| `2494100` | Account is in maintenance mode | Yes, later | — |
| `2593107` | Synchronization API call limit exceeded for this phone number | No | — |
| `2593108` | Synchronization can only be requested within 24 hours of onboarding | No | — |

## Troubleshooting / Technical Notes

* **My code isn't listed.** Open the failed message and read the **Reason** — it carries Meta's own explanation. If it's unclear, contact [Support](https://docs.skyfree.io/workspace/support.md) with the code.
* **The same code keeps coming back.** Fix the cause (see the guides below) instead of retrying.

## Related docs

* [Troubleshoot overview](https://docs.skyfree.io/troubleshoot/overview.md)
* [Message failed to send](https://docs.skyfree.io/troubleshoot/whatsapp/message-failed.md)
* [Template problems](https://docs.skyfree.io/troubleshoot/whatsapp/template-problems.md)
* [Number and account problems](https://docs.skyfree.io/troubleshoot/whatsapp/number-and-account.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.