Common Meta error codes and how to fix them
When WhatsApp can't deliver a message or refuses a change, Meta returns an error code.
- Who can use this
- Account owner, Manager, Agent
When WhatsApp can't deliver a message or refuses a change, Meta returns an error code.
When WhatsApp can't deliver a message or refuses a change, Meta returns an error code. The panel shows the code with a plain explanation. This page lists the codes customers meet most, what they mean and what to do. Descriptions are Meta's rules as captured in the panel's error catalog (checked 2026-10-22).
Note the code and the customer or number it is about. Support needs both.
Don't resend in a loop: repeated failures can lower your quality rating.
| Code | Meaning | What to do |
|---|---|---|
| 131047 (older systems: 470) | Re-engagement message: more than 24 hours since the customer last replied. | Send an approved template instead. |
| 131026 | Message undeliverable. The number isn't on WhatsApp, the customer hasn't accepted WhatsApp's latest terms, uses an old WhatsApp version, or you sent an authentication template to a +91 (India) number. | Ask the customer (another way) to check they can message your number and update WhatsApp. |
| 131049 | Meta chose not to deliver, to keep engagement healthy (per-customer marketing limit). | Don't retry right away; retry later with growing gaps. |
| 131051 | Unsupported message type. | See below. |
| 131052 | Media download error: Meta couldn't download media the customer sent. | Ask the customer to send it again. |
| 131053 | Media upload error, for example an unsupported media type. | Use a supported file type and size. |
| 131042 | Business eligibility payment issue. | Check billing in WhatsApp Manager: payment method, credit line, currency, timezone. |
| 131031 | Meta locked this WhatsApp Business account, usually after a policy issue. | Open WhatsApp Manager to see the reason and appeal. |
| 130497 | Your account is restricted from messaging users in this country. | Check WhatsApp's Business Messaging Policy for your category. |
| 131057 | Account in maintenance mode (for example a throughput upgrade). | Wait and try again. |
| 131009 | Parameter value is not valid. On a product carousel it usually means the catalog isn't connected to this WhatsApp number. | See Product carousel failed with 131009. Otherwise check the values you sent, or wait 10 minutes if the template is new. |
| 132000 | Template parameter count mismatch. | Fill every variable of the template. |
| 132001 | Template does not exist in that language, or isn't approved. | Check the template name, language and status. |
| 132005 / 132012 | Template parameter format error or mismatch. | Send values in the format the template expects. |
| 130472 | The customer's number is part of a Meta experiment. | Nothing to fix; contact WhatsApp support if needed. |
| 130429, 131048, 131056, 80007 | Meta throttling (throughput, spam rate, too many messages to one customer, rate limit). | Send more slowly; wait for the cooldown. |
| 190 | The connection to Meta expired. | Reconnect the number. |
Meta sends 131051 ("unsupported message type", shown by Meta as "Message type unknown") when a message uses a type the WhatsApp Business Platform can't pass on. Meta then sends the message without its content: no text, no buttons, no code.
In the inbox it appears as a message that reads "[Unsupported message type, it may be a video note, poll, event, or other unsupported type.]".
Common cases:
What to do:
When a carousel of products from your catalog fails with 131009, the "Message not delivered" box adds a hint: "This carousel failed because the catalog isn't connected to this WhatsApp number. Connect it in WhatsApp Manager, or send the products as a list." (It says "most likely failed" when Meta's reason doesn't name the catalog.)
What to do:
| Code | Meaning | What to do |
|---|---|---|
| 133000 | A previous turn-off didn't finish. | Turn the number off again, then reconnect. |
| 133004 | WhatsApp is temporarily unavailable. | Wait a few minutes. |
| 133005 | The two-step PIN doesn't match. | Enter the right PIN or reset it in WhatsApp Manager. Don't keep retrying. |
| 133006 | Phone verification needed. | Request a 6-digit code by SMS or voice call. |
| 133008 / 133009 | Too many wrong PIN attempts / PIN entered too quickly. | Wait, or reset the PIN in WhatsApp Manager. |
| 133010 | The number is off on WhatsApp. | Use Reconnect number. |
| 133015 | The number was just turned off. | Wait about 5 minutes. |
| 133016 | Too many turn-on/turn-off attempts (10 per 72 hours). | Wait for the window to reset. |
| 136024 | Already verified. | Continue to register. |
| 136025 | That code didn't work. | Check the code or ask for a new one. |
| 131037 | Not available for this number (test number, or name not yet approved). | Use a real, approved number. |
| 139000–139999 | WhatsApp Flows errors (139000 blocked by integrity; 139001 only editable in draft). | See WhatsApp Flows. |
Error codes are Meta's. Your plan doesn't change them.
Do it with Copilot
(logs_search with the contact, or inbox_list_messages with failed messages only; read-only.)
Do it with Copilot
Do it with Copilot
(channels_health, read-only.)
| What you see | Why | What to do |
|---|---|---|
| "Something went wrong. Please try again later." | The error had no known code. | Try again; if it repeats, contact support with the time and number. |
| Many failures at once across numbers | Meta outage. | Wait and check Meta's status page. |