WhatsApp error codes
What each Meta error code means when a WhatsApp message, template, registration, or call fails, and what to do about it.
When WhatsApp rejects something, OmniDimension shows Meta's error code and, for the codes below, what it means and what to do. This page is the same list.
Messages, templates and registration
| Code | What it is | What happened | What to do |
|---|---|---|---|
0 | Meta connection failed | The access token for this number expired, was reset, or had its access removed. | Reconnect the number so Meta issues a new access token. |
1 | Meta rejected the request | Meta could not process the request, either because a value in it was wrong or because Meta had a problem of its own. | Try again in a few minutes. If it keeps happening, contact support with the time it failed. |
2 | WhatsApp is temporarily unavailable | Meta's service is down or overloaded right now. | Wait about five minutes and try again. |
3 | Missing WhatsApp permission | The connection to Meta does not have the permissions this action needs. | Reconnect the number and grant both WhatsApp permissions Meta asks for, whatsapp_business_management and whatsapp_business_messaging. |
4 | Too many requests | Too many requests went to Meta in a short time. | Slow down and try again in a few minutes. |
10 | Permission not granted | Meta has not granted a permission this action needs, or it was removed. On calling, it can also mean business-started calls are not available in the recipient's country. | Reconnect the number and grant both whatsapp_business_management and whatsapp_business_messaging. If this came from a call, check Meta's country availability list. |
33 | Phone number no longer exists | The business phone number was deleted at Meta, so it cannot be used. | Check the number in WhatsApp Manager. If it was removed, add it again and connect it here. |
100 | Invalid request | Meta rejected a value in the request. | Meta's message names the field. If it mentions a template variable, fix the template's variables and try again. |
100/33 | WhatsApp account not found | The WhatsApp Business Account this number belonged to was most likely deleted, so Meta can no longer load it. | Check the account still exists in WhatsApp Manager before regenerating the token. If it is gone, connect the number under an account that exists. |
100/1752203 | Connection cannot list WhatsApp accounts | The Meta connection is missing the business_management permission, so it cannot list the WhatsApp Business Accounts it has access to. | Generate the token again with business_management granted, then reconnect. |
100/2388001 | Number still linked to the WhatsApp app | This number is still registered on the WhatsApp Business app on a phone, so the Cloud API cannot take it over. | Delete the WhatsApp Business app account for this number on the phone, wait a few minutes, then register again. |
100/2388339 | Test account cannot hold this number | This WhatsApp Business Account is a test account, and test accounts only carry the test number Meta provides. | Use a production WhatsApp Business Account for this number. |
190 | Meta connection expired | The access token for this number has expired. | Reconnect the number so Meta issues a new token. |
200 | Missing Meta permission | A permission this action needs is missing from the Meta connection or was removed. | Reconnect the number and grant the WhatsApp permissions Meta asks for. Listing WhatsApp Business Accounts also needs business_management. |
368 | WhatsApp account restricted | Meta has restricted or disabled this WhatsApp Business Account for breaking its policies. | Read the enforcement notice in WhatsApp Manager and appeal there if you think it is wrong. |
80007 | Account rate limit reached | This WhatsApp Business Account made too many requests to Meta in a short time. | Slow down and try again later. |
130403 | You blocked this person | Your business has blocked this customer, so messages cannot reach them. | Unblock the customer in WhatsApp Manager if you want to message them again. |
130429 | Sending too fast | Messages are going out faster than WhatsApp allows for this number. | Reduce the sending rate and try again. |
130497 | Country not allowed | Meta does not allow this WhatsApp Business Account to message people in that country. | Remove numbers from that country from your list, or check Meta's business messaging policy for where you can send. |
131000 | Message failed | WhatsApp could not send the message and did not say why. | Try again. If it keeps failing, contact support with the time and the recipient. |
131005 | Permission denied | The Meta connection is missing a permission needed to send. | Reconnect the number and grant the WhatsApp permissions Meta asks for. |
131008 | Something is missing from the message | A value the message needs was not included. | Check that every template variable and the recipient's details are filled in. |
131009 | A value was not accepted | One of the values sent is not valid. On a call button, it can also mean the button is not supported in your number's country. | Check the template's variables and the recipient's number. If this came from a call button, check Meta's country availability list. |
131016 | WhatsApp is temporarily unavailable | Meta's service is briefly unavailable. | Try again in a few minutes. |
131021 | Sending to your own number | The recipient is the same as your business number, and WhatsApp does not allow that. | Send to a different number. |
131026 | Could not be delivered | The number is not on WhatsApp, the app is too old, or the person has not accepted WhatsApp's terms. | Check the number is on WhatsApp and ask the customer to update the app. |
131031 | Account restricted or unverified | Meta has restricted this WhatsApp Business Account for a policy breach, or business verification did not pass. | Read the notice in WhatsApp Manager, then complete business verification or appeal there. |
131037 | Display name not approved | A 555 test number was used without an approved business display name. | Get the display name approved in WhatsApp Manager before sending from that number. Meta's message names the number. |
131042 | Billing problem at Meta | There is a problem with the payment method Meta bills for this account. | Fix the payment method in WhatsApp Manager under Settings, Payment methods. |
131045 | Number not registered properly | This number is not registered with WhatsApp's business platform, so it cannot send. | Register the number again from its settings. |
131047 | Reply window closed | More than 24 hours passed since this customer last messaged you, so WhatsApp only allows an approved template now. | Send an approved template message. Once the customer replies, free-form messages work again for 24 hours. |
131048 | Sending paused for quality | Meta has limited sending from this number because its quality rating dropped. | Check the quality rating in WhatsApp Manager and send fewer, more relevant messages until it recovers. |
131049 | Held back by Meta | Meta limits how many marketing messages one person receives, and this one was held to keep WhatsApp useful for them. | Wait 24 hours before retrying. If the message matters to the customer (a reminder, an alert, a fee notice), send it as a utility template instead. |
131050 | Customer opted out | This customer told WhatsApp they no longer want marketing messages from you. | Do not send this customer marketing messages again. Utility and authentication templates are still allowed. |
131051 | Message type not supported | WhatsApp does not support this kind of message here. | Send a supported type, such as text, an image, or an approved template. |
131052 | Could not read the customer's file | WhatsApp could not download the photo, video, or document the customer sent. | Ask the customer to send it again, or to describe it in a message. |
131053 | Could not send the file | WhatsApp would not accept the photo, video, or document attached to this message. | Check the file type and size against WhatsApp's limits, then try a smaller or different file. |
131056 | Too many messages to one person | Too many messages went to this customer in a short time. | Wait a while before messaging that customer again. |
131057 | Account in maintenance | Meta has this WhatsApp Business Account in maintenance mode. | Try again later. |
131058 | Sample template on a real number | The Hello World sample template only works from Meta's public test numbers, not from your own. | Create your own template, get it approved, then send that. |
131063 | Marketing messages turned off | Marketing templates are switched off for this number. | Turn marketing messages back on in WhatsApp Manager. |
131064 | Messaging limit cut for template misuse | Meta lowered this account's messaging limit because templates were sent under the wrong category. | Review your templates' categories in WhatsApp Manager and correct any marketing message sent as a utility. |
132000 | Wrong number of template values | The message supplied a different number of values than the template expects. | Fill in every variable the template has, in the same order. |
132001 | Template not found | No approved template with that name exists in that language. | Check the template's name and language, and that Meta has approved it. |
132005 | Translation too long | One of the template's translations is longer than WhatsApp allows. | Shorten the translation in WhatsApp Manager and submit it again. |
132007 | Template breaks WhatsApp policy | Meta rejected the template's content for breaking its rules. | Rewrite the template to follow Meta's template guidelines and submit it again. |
132012 | Value in the wrong format | A value does not match the format the template expects, such as a date or an amount. | Use the format the template defines and try again. |
132015 | Template paused | Meta paused this template because customers reacted badly to it, and messages waiting on it are dropped. | Edit the template to make it more relevant and wait for the pause to lift. |
132016 | Template disabled for good | Meta paused this template too many times and has now disabled it permanently. | Create a new template with different wording. |
132068 | Flow blocked | WhatsApp blocked the WhatsApp Flow attached to this message. | Correct the flow in WhatsApp Manager and try again. |
132069 | Flow sending limit reached | This WhatsApp Flow has already been sent 10 times in the last hour. | Wait for the hour to pass, and correct the flow in WhatsApp Manager. |
133000 | Could not remove the registration | WhatsApp could not deregister this number. | Try deregistering again, then register the number. |
133004 | WhatsApp is temporarily unavailable | Meta's registration service is briefly unavailable. | Try again in a few minutes. |
133005 | Wrong two-step PIN | The six digit PIN entered for this number is not the right one. | Enter the correct PIN, or reset it in WhatsApp Manager and try again. |
133006 | Number not verified | Meta has not verified this number yet, so it cannot be registered. | Verify the number with the code Meta sends, then register it. |
133008 | Too many PIN attempts | The PIN was entered wrong too many times, so Meta has blocked further attempts for a while. | Wait for the block to pass before trying again. A wrong code can lock a number for around 12 hours. |
133009 | PIN entered too soon | The PIN was submitted faster than Meta allows. | Wait a moment and try again. |
133010 | Number not registered | This number is not registered with WhatsApp's business platform. | Register the number with a six digit PIN from its settings. |
133015 | Number was just deleted | The number was deleted a moment ago and Meta is still clearing it. | Wait five minutes and try again. |
133016 | Too many registration attempts | This number was registered or verified too many times recently. Meta allows about 10 attempts every 72 hours. | Wait for the block to lift before trying again. Retrying blindly makes it last longer. |
134011 | Payments terms not accepted | WhatsApp payments cannot be used until the terms of service are accepted. | Accept the WhatsApp payments terms in WhatsApp Manager. |
135000 | Meta could not process the request | Meta rejected the request and did not explain why. | Try again. If it keeps failing, contact support with the time it happened. |
141006 | No payment method on this WhatsApp account | This WhatsApp Business Account has no payment method attached. A card on the business portfolio does not count. | Add a payment method in WhatsApp Manager under Settings, Payment methods, for this WhatsApp Business Account. |
141008 | WhatsApp account not active | Meta has put this WhatsApp Business Account in a state that is not active, and only Meta support can clear it. | Raise a support ticket with Meta about the account and WhatsApp Business Account status. |
141014 | WhatsApp account banned | Meta has banned this WhatsApp Business Account. The ban covers the whole business portfolio, so creating another account or claiming a test number is blocked too. | Appeal at business.facebook.com/accountquality. Nothing can be sent until Meta lifts the ban. |
200000/3095008 | Account cannot hold another number | This WhatsApp Business Account was created through the WhatsApp Business app and holds exactly one number, so it will not take another. | Use a different WhatsApp Business Account for the new number. |
200005 | Insights not available | Meta does not make conversation insights available for this account. | Use WhatsApp Manager for reporting instead. |
200006 | Insights cannot be turned off | Meta does not allow conversation insights to be turned off for this account. | No action is needed. Insights stay on. |
200007 | Insights not turned on | Conversation insights are not turned on for this account. | Turn insights on in WhatsApp Manager first. |
2388012 | Number already added | This number is already in the WhatsApp Business Account. | Use the number that is already connected, or add a different one. |
2388019 | Template limit reached | This account already has the maximum of 250 templates. | Delete templates you no longer use, then create the new one. |
2388039 | Template still under review | The template cannot be changed while Meta is reviewing it. | Wait for the review to finish, then make the change. |
2388040 | Template text too long | One of the template's fields is longer than WhatsApp allows. | Shorten the text and submit the template again. |
2388047 | Header formatting not accepted | The template's header does not follow WhatsApp's formatting rules. | Fix the header and submit the template again. |
2388072 | Body formatting not accepted | The template's body does not follow WhatsApp's formatting rules. | Fix the body text and submit the template again. |
2388073 | Footer formatting not accepted | The template's footer does not follow WhatsApp's formatting rules. | Fix the footer and submit the template again. |
2388091 | Cannot get a code this way | This number is not eligible for the shortcut registration code. | Register the number the standard way, with a code sent by SMS or a phone call. |
2388093 | Cannot verify a code this way | This number is not eligible to verify with the shortcut code. | Register the number the standard way, with a code sent by SMS or a phone call. |
2388103 | Migration could not finish | Something in the account setup blocked the migration, usually the webhook settings, the display name, or an incomplete account. | Check the display name and webhook settings in WhatsApp Manager, then run the migration again. Meta's message names the exact problem. |
2388293 | Too many variables for the text | The template has more variables than its amount of fixed text allows. | Use fewer variables, or write more fixed text around them. |
2388299 | Variable at the start or end | A template variable sits right at the start or the end of the text, which WhatsApp does not allow. | Move the variable so there is fixed text before and after it. |
2494100 | Number in maintenance | Meta has this business number in maintenance. | Try again in a few minutes. |
2593107 | Sync limit reached | This account has hit Meta's sync limit. | Disconnect the number and connect it again. |
2593108 | Contact sync window closed | Contacts can only be synced within 24 hours of connecting the number. | Disconnect the number and connect it again to open a new sync window. |
Calling
| Code | What it is | What happened | What to do |
|---|---|---|---|
613 | Too many call permission checks | Call permission was checked too many times in a short window. | Wait a little and try again. |
131030 | Recipient not on the allowed list | This is a Meta test number, and it can only reach recipients you have added to its allowed list. | Add the recipient in the test number's settings at Meta, or use a production number. |
131044 | No payment method for calling | The call could not go through because this WhatsApp Business Account has no valid payment method. | Add a payment method in WhatsApp Manager under Settings, Payment methods, for this WhatsApp Business Account. |
131055 | Number is set up for SIP | This number routes calls through SIP (a phone-system link), so calls cannot be placed the usual way. | Turn SIP off for this number if you want to place calls from here. |
138000 | Calling is not turned on | Calling is off for this number at Meta. | Turn on calling from the number's Calls setting. |
138001 | Customer cannot be called | The customer is not on WhatsApp, has an old version of the app, or has not accepted WhatsApp's terms. | Check the number is on WhatsApp and ask the customer to update the app. |
138002 | Too many calls at once | This number already has the maximum of 1,000 calls running at the same time. | Wait for calls to finish, then try again. |
138003 | Call already in progress | There is already a call running with this customer. | Wait for that call to end before starting another. |
138004 | Call could not connect | The call failed while it was connecting. | Try the call again. |
138005 | Calling too fast | This number started more calls than Meta allows in a short time. | Slow down and try again in a few minutes. |
138006 | Customer has not allowed calls | The customer has not given your business permission to call them. Meta also returns this when the number is not on WhatsApp at all. | Ask for call permission in a message first, and check the number is on WhatsApp. |
138007 | Call setup timed out | The call took too long to connect and WhatsApp gave up. | Try the call again. |
138009 | Too many permission requests | You have asked this customer for call permission too many times. | Stop asking for now. The limit resets once a call with that customer connects. |
138012 | Daily calling cap reached | This number has already connected the maximum of 100 business-started calls in 24 hours. | Wait for the cap to reset. Meta's message names the next allowed time. |
138013 | Calling not available in that country | Meta does not allow business-started calls to that country yet. | Check Meta's country availability list. You can still take calls the customer starts. |
138014 | Calling paused by Meta | Meta has paused calling on this number because of its quality rating. | Keep messaging relevant and wanted. Meta lifts the pause on its own once the rating recovers. |
138015 | Messaging limit too low for calling | Meta only allows calling once your WhatsApp Business Account can message at least 2,000 people a day. The limit is per business portfolio, not per number. | Meta raises the limit after business verification and healthy sending. Check it in WhatsApp Manager under the phone number's settings. |
138017 | Permission already granted | This customer has already given permanent call permission, so asking again is not needed. | Place the call directly instead of asking for permission. |
138018 | Calls webhook not set up | Your Meta app is not subscribed to the calls webhook, so Meta has nowhere to send incoming calls. | Connect replies on this number, or in your Meta app's WhatsApp webhook settings subscribe to the calls field. |
138019 | Customer's app could not set up the call | The call failed on the customer's phone while it was being set up. | Try the call again later. |
138020 | Customer's app could not connect the audio | The customer's phone could not reach WhatsApp's audio servers. | Try the call again later. A weak connection on the customer's side is the usual cause. |
138021 | No audio reached the customer | The customer's phone received no audio from your side and dropped the call. | Try the call again. If it keeps happening, contact support with the call time. |
138022 | Audio stopped during the call | The call was dropped after audio stopped flowing. | Try the call again later. |
138023 | Call answered but audio never started | The call was answered, but WhatsApp never saw audio flowing, so it could not tell whether it connected. | Try the call again later. |
Codes not listed here are shown with Meta's own message. Meta's full reference: Cloud API error codes and calling errors.