Meta error codes and how to fix them
The WhatsApp Cloud API errors you're most likely to see in Vatli, what each one means and what to do.
Where you see them: Failed messages in the inbox, broadcast reports, automation logs and API responses
Vatli shows Meta’s code with a plain-language explanation. The most common ones:
| Code | What it means | What to do |
|---|---|---|
| 131047 | More than 24 hours since the customer last messaged you | Send an approved template. When they reply, you can chat normally again. |
| 131026 | Message undeliverable — number not on WhatsApp, wrong, or missing country code | Check the number and its country code. Remove numbers that keep failing. |
| 131049 | Meta withheld this marketing message because of engagement limits | Don’t retry immediately. Wait 24 hours, or use a Utility template if it’s transactional. See Marketing message limits. |
| 131056 | Too many messages to the same number in a short time | Wait a few minutes before retrying. |
| 130429 | Throughput limit reached | Nothing — broadcasts keep draining as capacity frees up. |
| 131021 | Sender and recipient are the same number | Test from a different phone. |
| 131058 | hello_world sent from a real business number |
Create and send your own approved template. |
| 132000 | Number of variables doesn’t match the template | Fill in every {{1}}, {{2}} the template declares. |
| 132001 | Template doesn’t exist in that language | Check the name and language — en_US and en are different. |
| 132005 | Message too long after variables are filled in | Shorten the variable values or the template body. |
| 132007 | Content breaks Meta’s template rules | Often a variable at the very start or end, or two variables in a row. Edit and resubmit. |
| 132012 | A variable value has a format Meta rejects | Remove newlines, tabs or 4+ spaces in a row from variable values. |
| 133010 | Phone number not registered with the Cloud API | Finish registration in WhatsApp Manager, then click Verify registration in Settings → WhatsApp. |
| 131031 | Meta restricted or locked the WhatsApp Business Account | Check Business Manager → Account Quality. This must be resolved with Meta. |
| 131008 | A required field was missing | Check the message or template configuration. |
| 190 | Access token expired or revoked | Re-enter it in Settings → WhatsApp. Use a permanent System User token. |
Template submission errors
| Message from Meta | What to do |
|---|---|
| Template is being deleted | Meta is still deleting an earlier version with that name. Wait a minute and resubmit, or use a slightly different name. |
| Template name already exists | Edit the existing template, or use a different name. |
More: Template send errors and Message failed.