# Meta error codes

## Throttling error

| Code                                                                                             | Details                                                                                                                                                                    | Possible causes and solutions                                                                                                                                                                                                                                                                                                                     | HTTP status code |
| ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| <p><code>4</code></p><p>Too many API calls</p>                                                   | This app has reached its API call traffic limit.                                                                                                                           | In[App Dashboard](https://developers.facebook.com/apps)load this app, then check the**App Rate Limits**section to confirm whether this app has reached its[rate limits](https://developers.facebook.com/docs/graph-api/overview/rate-limiting#wa-biz-api). If it has, try again later or reduce how often or how many API queries this app makes. | `400`Bad request |
| <p><code>80007</code></p><p>Rate limit issue</p>                                                 | The WhatsApp Business account has reached its rate limit.                                                                                                                  | See the WhatsApp Business account[rate limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#rate-limits). Try again later; or reduce how often or how many API queries this app makes.                                                                                                            | `400`Bad request |
| <p><code>130429</code></p><p>Throughput reached</p>                                              | Cloud API message throughput reached.                                                                                                                                      | This app has reached the API throughput limit. See[Throughput](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput). Try again later; or reduce how frequently this app sends messages.                                                                                                                          | `400`Bad request |
| <p><code>131048</code></p><p>Spam rate limit reached</p>                                         | This phone number is limited in how many messages it can send, so message sending failed. This can be because too many messages were previously blocked or marked as spam. | Check your quality status in the WhatsApp Manager. See[Template limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview#template-limits)and[Template quality](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality).                                 | `400`Bad request |
| <p><code>131056</code></p><p>Pairing rate limit reached (business account, consumer account)</p> | Too many messages were sent in a short time from the sender phone number to the same recipient phone number.                                                               | If you need to send messages to the same phone number, wait and retry the operation. You can still send messages to other numbers without waiting                                                                                                                                                                                                 | `400`Bad request |
| <p><code>133016</code></p><p>Exceeded account registration/unregistration attempt limit</p>      | Failed to successfully register or unregister this phone number due to too many attempts in a short period.                                                                | This business phone number was blocked for reaching the maximum number of registration/unregistration attempts. After the number is unblocked, try again. See the[Registration](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)documentation's "Limits" section.                   | `400`Bad request |

## Other errors

<table data-header-hidden><thead><tr><th></th><th width="192.45703125"></th><th width="353.25390625"></th><th></th></tr></thead><tbody><tr><td>Code</td><td>Details</td><td>Possible causes and solutions</td><td>HTTP status code</td></tr><tr><td><p><code>130472</code></p><p>User's number involved in an experiment</p></td><td>The message was not sent as part of an<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/support/experiments">experiment</a>.</td><td>See<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/support/experiments#marketing-message-experiment">Marketing message experiment</a>.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131000</code></p><p>errored</p></td><td>An unknown error occurred, so message sending failed.</td><td>Try again. If the error persists, create a<a href="https://business.facebook.com/direct-support">direct support</a>ticket. For WhatsApp Flows that use the endpoint - when<a href="https://developers.facebook.com/docs/whatsapp/cloud-api/reference/whatsapp-business-encryption#set-business-public-key">Setting the business public key</a>the signature cannot be computed or the GraphQL endpoint cannot be called, or the GraphQL endpoint returns an error.</td><td><code>500</code>Internal server error</td></tr><tr><td><p><code>131005</code></p><p>Access denied</p></td><td>Permission not granted or permission removed.</td><td>Use the<a href="https://developers.facebook.com/tools/debug/accesstoken">Access Token Debugger</a>to confirm whether your app has the permissions required by the endpoint. See<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/support#authentication-authorization">Authentication and authorization errors</a>.</td><td><code>403</code>Forbidden</td></tr><tr><td><p><code>131008</code></p><p>Required parameter missing</p></td><td>A required parameter is missing from the request.</td><td>See the endpoint reference docs to determine which parameters are required.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131009</code></p><p>Invalid parameter value</p></td><td>One or more parameter values are invalid.</td><td>See the reference docs for this endpoint to determine which values each parameter supports; see<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers">Phone numbers</a>to learn how to add phone numbers to a WhatsApp Business account.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131016</code></p><p>Service unavailable</p></td><td>Service temporarily unavailable.</td><td>Visit the <a href="https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api%3Ffbclid%3DIwZXh0bgNhZW0CMTAAYnJpZBExbE9VS2JWNHdDYmhoeGEyTHNydGMGYXBwX2lkEDIyMjAzOTE3ODgyMDA4OTIAAR7EwI3ZeWkET0sv1d6qOrSD0EpoQ_Q1Mk2PQW7RwhWbCn75U-eiQJ_KDp0ngQ_aem_4xCDGSMuoqb1wpbLeXHEtA&#x26;h=AT1-HiPjeXGiLt1BiGu1049D_WZ7upc-8sNO1mNYIEEZACB3rt71Yz171vvn4L_RFbrd3KCzjpPyD04aw8m3d2RL5XpZJ5FokjpSwGDAoZ3z0nupqTZS6e4zgm-Xa1D5jKbRobWTbfM">WhatsApp Business Platform Status</a>page to view API status information, then try again.</td><td><code>500</code>Internal server error</td></tr><tr><td><p><code>131021</code></p><p>Recipient cannot be the sender</p></td><td>Sender and recipient phone numbers are the same.</td><td>Send the message to a phone number different from the sender.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131026</code></p><p>Message undeliverable</p></td><td><p>The message could not be delivered. Reasons may include:</p><ul><li>The recipient's phone number is not a WhatsApp number.</li><li>The recipient has not accepted our new Terms of Service and Privacy Policy.</li><li><p>The recipient is using an old version of WhatsApp; they must use the following WhatsApp versions or newer:</p><ul><li>Android: 2.21.15.15</li><li>SMBA: 2.21.15.15</li><li>iOS: 2.21.170.4</li><li>SMBI: 2.21.170.4</li><li>KaiOS: 2.2130.10</li><li>Web: 2.2132.6</li></ul></li></ul></td><td><p>If using a non‑WhatsApp contact method, ask the WhatsApp user to:</p><ul><li>Confirm they can actually send messages to your WhatsApp Business phone number.</li><li>Confirm they have accepted our latest Terms of Service (if they haven't yet accepted, the system will prompt them to accept the latest terms/policies in<strong>Settings</strong> > <strong>Help</strong>or in<strong>Settings</strong> > <strong>App Info</strong>).</li><li>Update to the latest WhatsApp client.</li></ul></td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131037</code></p><p>Phone numbers provided by WhatsApp require an approved display name before messages can be sent.</p></td><td>The <a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/overview#555-business-phone-numbers">555 business phone number</a>used to send the request does not have an approved<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/docs/whatsapp/display-names">display name</a>.</td><td>for the 555 business phone number. Also see our Help Center article<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/display-names">display name</a>How to change your WhatsApp Business display name<a href="https://www.facebook.com/business/help/378834799515077">for instructions.</a>article.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131042</code></p><p>Business payment eligibility issue</p></td><td>There is an issue with your payment method.</td><td><p>See <a href="https://www.facebook.com/business/help/2225184664363779">Billing overview for WhatsApp Business account</a>to confirm whether you have set up billing correctly. Common issues:</p><ul><li>WhatsApp Business account not linked to a payment account</li><li>Quota exceeded</li><li>Quota not set or enabled (payment account)</li><li>WhatsApp Business account deleted</li><li>WhatsApp Business account deactivated</li><li>Timezone not set</li><li>Currency not set</li><li>MessagingFor request (on behalf) pending or denied</li></ul></td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131045</code></p><p>Incorrect certificate</p></td><td>Message sending failed because of a phone number registration error.</td><td><a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration">Register the phone number</a>and then retry.</td><td><code>500</code>Internal server error</td></tr><tr><td><p><code>131047</code></p><p>Re‑engagement message</p></td><td>More than 24 hours have passed since the recipient last replied to the sender number.</td><td>Instead, send the recipient a<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview">template message</a>.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131049</code></p><p>Meta chose not to deliver.</p></td><td>To maintain a healthy ecosystem, this message was not delivered.</td><td>If you receive this error code and suspect it is due to this restriction, wait at least 24 hours before resending a template message. Because this restriction can be enforced at varying times, resending immediately will likely result in another error response. See<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits">Marketing template message limit per user</a>.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131050</code></p><p>User opted out of marketing messages.</p></td><td>Message undeliverable. The recipient has chosen to stop receiving marketing messages from businesses via WhatsApp.</td><td>Do not attempt to send messages to this user again, because they will not receive them. To be notified whenever a WhatsApp user stops or resumes receiving marketing template messages from you, subscribe to <a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/user_preferences">user_preferences webhook</a>.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131051</code></p><p>Message type not supported</p></td><td>Message type not supported.</td><td>See<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages#message-types">Message</a>to learn about supported message types, then retry using a supported message type.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131052</code></p><p>Error downloading media</p></td><td>Unable to download media sent by the user.</td><td>We cannot download the media included in the message sent by this WhatsApp user. For details, see any<strong>Message</strong> value in the Webhook that was triggered when the message was received. <code>error.error_data.details</code> Have the WhatsApp user send the media file to you using a non‑WhatsApp method.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131053</code></p><p>Error uploading media</p></td><td>Unable to upload the media used in the message.</td><td>We couldn't upload the media for one or more reasons (for example, unsupported media type). For details, see any<strong>Message</strong> value in the Webhook that was triggered when the message was received. <code>error.error_data.details</code> values triggered when message sending failed. We recommend checking any media files that caused the error and confirming those files are actually supported. For example, on UNIX you can check a file's MIME type from the command line using:<code>file -I rejected-file.mov</code>Then you can confirm whether its MIME type is supported. See<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types">Supported media types</a>.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>131057</code></p><p>Account in maintenance mode</p></td><td>Business account in maintenance mode</td><td>The WhatsApp Business account is currently in maintenance mode. One possible reason is that the account is undergoing an<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput">Throughput</a>upgrade.</td><td><code>500</code>Bad request</td></tr><tr><td><p><code>132000</code></p><p>Template parameter count mismatch</p></td><td>The number of variable parameter values included in the request does not match the number of variables defined in the template.</td><td>See our<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview#parameter-formats">Templates</a>documentation to learn about parameters, and ensure the request includes all parameter values the template requires.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>132001</code></p><p>Template does not exist</p></td><td>The template does not exist in the specified language or has not yet been approved.</td><td>Ensure your template is approved and that the template name and language settings are correct. See our<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview">Templates</a>documentation for details about templates.</td><td><code>404</code>Not found</td></tr><tr><td><p><code>132005</code></p><p>Template filler text too long</p></td><td>Translated text too long.</td><td>Check WhatsApp Manager to confirm the template has been translated. See our<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality">Template quality</a>documentation to learn how to check template status.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>132007</code></p><p>Violation of template formatting character policy</p></td><td>Template content violates WhatsApp policies.</td><td>See our<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review">Template review</a>documentation to learn possible reasons for violations.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>132012</code></p><p>Template parameter format mismatch</p></td><td>Variable parameter values have incorrect format.</td><td>The variable parameter values included in the request do not use the format specified in the template. See our<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview#parameter-formats">Templates</a>documentation for details about template parameters and formatting.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>132015</code></p><p>Template suspended</p></td><td>The template was suspended due to<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality">low quality</a>so you cannot send this template in a template message.</td><td><a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-management#edit-templates">Edit the template</a>to improve its quality, and retry after the template is approved.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>132016</code></p><p>Template disabled</p></td><td>The template has been suspended multiple times for<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality">low quality</a>and is now permanently disabled.</td><td>Create a new template with different content.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>132068</code></p><p>Flows blocked</p></td><td>Flows are in a blocked state.</td><td>Correct Flows</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>132069</code></p><p>Flows throttled</p></td><td>Flows are throttled; 10 messages using this Flow have been sent in the past hour.</td><td>Correct Flows</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>133000</code></p><p>Unregistration incomplete</p></td><td>A previous unregistration attempt failed.</td><td>Re<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration#deregister-phone">unregister</a>the number and then<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration">Registration</a>.</td><td><code>500</code>Internal server error</td></tr><tr><td><p><code>133004</code></p><p>Server temporarily unavailable</p></td><td>Server temporarily unavailable.</td><td>Visit the <a href="https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api%3Ffbclid%3DIwZXh0bgNhZW0CMTAAYnJpZBExbE9VS2JWNHdDYmhoeGEyTHNydGMGYXBwX2lkEDIyMjAzOTE3ODgyMDA4OTIAAR5fR8pg0B-IicB7-ftrE6-418relABYe1kdgQ5a2bXacuVyTSfzGxYw2C4Z6w_aem_QF3mdEnurygRKixWZdHStg&#x26;h=AT1-HiPjeXGiLt1BiGu1049D_WZ7upc-8sNO1mNYIEEZACB3rt71Yz171vvn4L_RFbrd3KCzjpPyD04aw8m3d2RL5XpZJ5FokjpSwGDAoZ3z0nupqTZS6e4zgm-Xa1D5jKbRobWTbfM">WhatsApp Business Platform Status</a>page to view API status info, check the <code>details</code> value in the response, and then try again.</td><td><code>503</code>Service unavailable</td></tr><tr><td><p><code>133005</code></p><p>Two‑step verification PIN mismatch</p></td><td>Two‑step verification PIN is incorrect.</td><td>Confirm the two‑step verification PIN included in the request is correct. To reset the PIN, disable two‑step verification, then set a new PIN. See<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#two-step-verification">Two‑step verification</a>.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>133006</code></p><p>Phone number needs re‑verification</p></td><td>The phone number must be verified before registration.</td><td><a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/registering-phone-numbers">Verify and register the phone number</a>.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>133008</code></p><p>Two‑step verification PIN attempts exceeded</p></td><td>Too many two‑step verification PIN attempts for this phone number.</td><td>In <code>details</code> Retry after the time specified in the response value.</td><td><code>400</code>Bad request</td></tr><tr><td><p><code>133009</code></p><p>Two‑step verification PIN attempts too fast</p></td><td>Two‑step verification PIN entered too quickly.</td><td>Check the <code>details</code> response value, then try again.</td><td><code>400</code>Invalid request</td></tr><tr><td><p><code>133010</code></p><p>Phone number not registered</p></td><td>The phone number is not registered on the WhatsApp Business Platform.</td><td><a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration">Register the phone number</a>and then retry.</td><td><code>400</code>Invalid request</td></tr><tr><td><p><code>133015</code></p><p>Wait a few minutes and then try registering the phone number again</p></td><td>The phone number you are currently trying to register was recently deleted but deletion is not yet complete.</td><td>Wait 5 minutes and then retry the request.</td><td><code>400</code>Invalid request</td></tr><tr><td><p><code>134011</code></p><p>Has not accepted WhatsApp payment terms</p></td><td>Message sending failed because this WhatsApp Business account is awaiting acceptance of WhatsApp payment terms.</td><td>Accept the WhatsApp payment terms using the link provided in the error message, then retry.</td><td><code>400</code>Invalid request</td></tr><tr><td><p><code>135000</code></p><p>General user error</p></td><td>There was an unknown error in your request parameters, so message sending failed.</td><td>See the<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/overview">reference docs</a>for this endpoint to confirm the syntax you used to query the endpoint is correct. If you continue to receive this error code in responses, contact<a href="https://developers.facebook.com/support/">Customer Support</a>.</td><td></td></tr></tbody></table>

## WhatsApp Marketing Messages API error codes

The WhatsApp Marketing Messages API uses the same error codes as the Cloud API and adds some additional error codes listed below.

<table data-header-hidden><thead><tr><th></th><th></th><th width="161.1015625"></th><th width="220.62890625"></th><th></th></tr></thead><tbody><tr><td>Code</td><td>Message</td><td>Details</td><td>Possible causes and solutions</td><td>HTTP<br>status<br>code</td></tr><tr><td><code>100</code></td><td><code>(#100) Invalid parameter</code></td><td><code>Message must be a template message.</code></td><td>You are attempting to send a non‑template message. Message type must be <code>template</code>. Please retry using a marketing template.</td><td>400 Bad Request</td></tr><tr><td><code>131009</code></td><td><code>(#131009) Parameter value is not valid</code></td><td><code>One or more parameter values are invalid.</code></td><td>A parameter you used may be invalid. Confirm you are using<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/send-marketing-messages">valid parameters</a>and then retry. Ad sync may not be complete. Wait 10 minutes and try again. If the problem persists, contact support.</td><td>400 Bad Request</td></tr><tr><td><code>131055</code></td><td><code>(#131055) Method not allowed</code></td><td><code>Only marketing template messages are supported</code></td><td>You might be attempting to send a non‑template message or an authentication or utility template. Try sending again using a marketing template message.</td><td>400 Bad Request</td></tr><tr><td><code>134100</code></td><td><code>(#134100) Only marketing messages supported</code></td><td><code>You're only able to send marketing messages on this API.</code></td><td><em>Will be launched in Graph API v23.0.</em>You are attempting to send utility or authentication templates. Only <code>MARKETING</code> class templates are supported.</td><td>400 Bad Request</td></tr><tr><td><code>134101</code></td><td><code>(#134101) Your template is still syncing</code></td><td><code>When you send a message from a template, the template syncing process can take up to 10 minutes to complete. Wait a few minutes, and then try sending your message again.</code></td><td><em>Will be launched in Graph API v23.0.</em>You are attempting to send a newly created template whose ad sync has not completed. Ad sync can take up to 10 minutes. Wait 10 minutes and try again.</td><td>400 Bad Request</td></tr><tr><td><code>134102</code></td><td><code>(#134102) Template unavailable for use</code></td><td><code>Please check your eligibility status to ensure you are onboarded (/documentation/business-messaging/whatsapp/marketing-messages/onboarding#ensure-you-are-eligible-to-onboard) or contact Meta's customer support.</code></td><td><em>Will be launched in Graph API v23.0.</em>We couldn't complete ad sync for the template you attempted to send, or you might not be eligible to use the WhatsApp Marketing Messages API.<a href="https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/onboarding#check-waba-onboarding-status-and-eligibility">Check your eligibility status</a>. If the WhatsApp Business account's <code>marketing_messages_lite_api_status</code>value is <code>ONBOARDED</code> and the issue persists,<a href="https://business.facebook.com/direct-support/">contact support</a>.</td><td>500 Internal Server Error</td></tr><tr><td><code>1752041</code></td><td><code>(#1752041) Duplicate Request</code></td><td><code>Duplicate Request is thrown when a client has already been invited to onboard by any partner.</code></td><td>Onboarding requests are limited to one per business customer; only the first partner that calls the Intention API can successfully submit the request. Once a customer is onboarded, all eligible WhatsApp Business Accounts (WABA) for that customer are automatically included in the process. If you receive an error indicating an onboarding request has already been made, no further action is required because all eligible WABAs for that customer will be included without additional steps.</td><td>400 Bad Request</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.innopaas.com/api-reference/api-reference-en/whatsapp-business-api/error-codes/meta-error-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.