WhatsApp Business API Error Codes explained and solved
Saw a number when a message failed or when connecting your number? Search it here to find out exactly what happened, whether it needs action from you or will succeed on a retry, and the practical steps to fix it.
No matching code. Check the number exactly as it appears — and if it is not listed here, contact us and we will help you read it.
Authorization errors
6WhatsApp no longer accepts your connection
WhatsApp could not confirm that your account is still authorised, so the action was not carried out. Usually the access token has...
Full explanation & fix → 3 Action neededYour WhatsApp connection lacks a needed permission
The action was refused over a capability or permission issue: your WhatsApp connection either does not have the capability this op...
Full explanation & fix → 10 Action neededPermission never granted or later removed
The action was blocked because a permission it depends on was either never granted or was removed afterwards. It can also appear w...
Full explanation & fix → 190 Action neededWhatsApp access token has expired
The access token that authorises your WhatsApp connection has expired, so WhatsApp refused the action. A new access token has to b...
Full explanation & fix → 200 Action neededNo access token was sent to WhatsApp
WhatsApp refused the action because no access token was included with it at all, and answered with "Provide valid app ID". This is...
Full explanation & fix → 200-299 Action neededA required permission is missing or was revoked
An error code in the 200–299 range means a permission your WhatsApp connection needs was either never granted or has since been re...
Full explanation & fix →Account restriction errors
3Account restricted for a policy violation
The WhatsApp Business Account associated with the app has been restricted or disabled for violating one of Meta's platform policie...
Full explanation & fix → 130497 Action neededMessaging blocked for the recipient's country
Your message was not delivered because your WhatsApp Business account is restricted from messaging people in certain countries, an...
Full explanation & fix → 131031 Action neededAccount restricted or details not verified
Your WhatsApp Business account is restricted or disabled — Meta stopped sending after a policy violation, or could not verify data...
Full explanation & fix →Template creation errors
7Template status cannot be changed right now
Your change to this message template was refused because the template's status cannot be changed at the moment — for example while...
Full explanation & fix → 2388040 Action neededA template field exceeds its character limit
One field in your message template is longer than the maximum number of characters allowed, so the template was not accepted. The...
Full explanation & fix → 2388047 Action neededTemplate header formatting is not valid
The header of your message template contains formatting WhatsApp does not accept, so the template was refused. This error points a...
Full explanation & fix → 2388072 Action neededTemplate body formatting is not valid
The body of your message template — its main text — contains formatting WhatsApp does not accept, so the template was refused. Thi...
Full explanation & fix → 2388073 Action neededTemplate footer formatting is not valid
The footer of your message template contains formatting WhatsApp does not accept, so the template was refused. This error points a...
Full explanation & fix → 2388293 Action neededToo many variables for the template length
Your template was refused because it holds too many variables for how short its wording is. WhatsApp weighs the number of variable...
Full explanation & fix → 2388299 Action neededVariable at the start or end of template
Your template was refused because a variable sits at the very start or the very end of the text. WhatsApp does not allow a templat...
Full explanation & fix →Template sending errors
1Phone migration errors
5Number already added to your WhatsApp account
The migration did not go through because the number you tried to move is already present in your WhatsApp account's list of number...
Full explanation & fix → 2388091 Action neededNumber isn't being migrated — register it instead
The registration code could not be sent or verified for this number because the number is not part of a phone number migration. Co...
Full explanation & fix → 2388093 Action neededNumber isn't being migrated — register it instead
The registration code could not be sent or verified for this number because the number is not part of a phone number migration. Co...
Full explanation & fix → 2388103 Action neededMigration blocked — destination account not fully set up
The number could not be moved because the WhatsApp Business Account you are moving it into has not been set up to receive message...
Full explanation & fix → 2494100 TransientNumber temporarily in maintenance mode
Your business number is in maintenance mode on WhatsApp right now, so the request could not be carried out. This is a temporary st...
Full explanation & fix →Template insights errors
3Template insights not available for this account
Template insights are not available yet for this WhatsApp Business Account, so they cannot be turned on at the moment.
Full explanation & fix → 200006 PermanentTemplate insights cannot be turned off
The request to switch template insights off did not go through. Once template insights have been enabled for a WhatsApp Business A...
Full explanation & fix → 200007 Action neededTemplate insights are not enabled yet
Template insights have not been enabled for this WhatsApp Business Account. They need to be turned on first.
Full explanation & fix →WhatsApp Business account errors
2WhatsApp Business account already flagged for migration
This WhatsApp Business account has already been marked to move to a different setup, so the connection cannot continue. Meta also...
Full explanation & fix → 2593085 PermanentOwnership transfer of the account cannot proceed
The WhatsApp Business account is not eligible for an ownership transfer, so the connection did not complete. Meta lists two possib...
Full explanation & fix →Synchronization errors
2Import limit reached for this number
After a business number is connected, its contacts can be imported once and its message history can be imported once. That limit h...
Full explanation & fix → 2593108 Action neededImport window closed 24 hours after connecting
Contacts and message history can only be imported within 24 hours of connecting the business number. More than 24 hours have passe...
Full explanation & fix →Rate and sending-limit errors
7Sending paused — the app hit its rate limit
Your message was not sent because the app that connects your account to WhatsApp reached the limit Meta sets on how many requests...
Full explanation & fix → 80007 TransientYour WhatsApp Business account hit its rate limit
Your message was not sent because your WhatsApp Business Account reached its rate limit. Too many requests were made in a short pe...
Full explanation & fix → 130429 TransientMessages sent faster than Cloud API accepts
Your message was not delivered because messages were going out faster than Cloud API accepts at one time — sending reached the fas...
Full explanation & fix → 131048 Action neededSending from this number is restricted
Your message was not sent because there are restrictions on how many messages can be sent from this number. Meta says this may be...
Full explanation & fix → 131056 TransientToo many messages to the same recipient
Your message was not delivered because too many messages were sent from your number to this same recipient in a short period of ti...
Full explanation & fix → 131064 Action neededSending limited by template classification violations
Your account reached its messaging limit because of template classification violations. This stops both template messages and dire...
Full explanation & fix → 133016 TransientToo many connection attempts for this number
Connecting or disconnecting your business number failed because it was attempted too many times in a short period. The number is n...
Full explanation & fix →Sending and connection errors
43Invalid request or a WhatsApp server error
WhatsApp reported either an invalid request or a possible server error, so the message was not sent. Meta's status page shows whet...
Full explanation & fix → 2 TransientWhatsApp service is down or overloaded
The message was not sent because the WhatsApp service was temporarily down or overloaded at that moment. Meta describes this condi...
Full explanation & fix → 33 Action neededThe sending business number has been deleted
The message was not sent because the business phone number used for sending has been deleted.
Full explanation & fix → 100 Action neededWhatsApp rejected a value in the message
The request included one or more fields that WhatsApp does not support or that were misspelled, so the message was not sent.
Full explanation & fix → 130403 Action neededNot delivered — you have blocked this recipient
This recipient is on your own block list, so the message was not delivered. Nothing you send will reach them while the block is in...
Full explanation & fix → 130472 TransientMessage not sent as part of an experiment
WhatsApp did not send this message as part of an experiment. Meta's entry for this code says nothing more about the experiment or...
Full explanation & fix → 131000 TransientUnknown error stopped the message
An unexpected WhatsApp error occurred while sending, and the message did not go out. WhatsApp gave no specific reason for the fail...
Full explanation & fix → 131005 Action neededPermission not granted or was removed
The permission required for this action was either never granted or has since been removed, so the action did not go through. Meta...
Full explanation & fix → 131008 Action neededA required field is missing from the message
A required field is missing from the message, so WhatsApp refused to send it. The message cannot go out until every mandatory fiel...
Full explanation & fix → 131009 Action neededInvalid value in a message field
One or more values in the message are not valid, so WhatsApp would not send it. Meta's guidance for this code also covers how to a...
Full explanation & fix → 131016 TransientA WhatsApp service is temporarily unavailable
The message was not sent because one of the WhatsApp services was temporarily unavailable.
Full explanation & fix → 131021 Action neededSender and recipient numbers are the same
The message can't be sent to the sender's own number. The recipient number used is the same as your business number, and WhatsApp...
Full explanation & fix → 131026 Action neededMessage could not be delivered to this number
Undeliverable — the number isn't on WhatsApp or can't receive this message. Reasons can include that it is not a WhatsApp number,...
Full explanation & fix → 131037 Action neededYour business number has no approved display name
The message was not sent because the business phone number used for sending does not have an approved display name. WhatsApp will...
Full explanation & fix → 131042 Action neededA payment method problem is blocking sending
There was an error related to your payment method, and sending has stopped because of it. Sending stays blocked until the billing...
Full explanation & fix → 131045 Action neededPhone number registration error
The message failed to send because of a phone number registration error. Meta's fix is to register the phone number before trying...
Full explanation & fix → 131047 Action neededThe 24-hour reply window has closed
More than 24 hours have passed since the recipient last replied to your number, so a regular message was not accepted. A template...
Full explanation & fix → 131049 TransientMessage not delivered to keep engagement healthy
WhatsApp did not deliver this message in order to maintain healthy ecosystem engagement. Meta's guidance suggests the cause may be...
Full explanation & fix → 131050 PermanentRecipient opted out of your marketing messages
This recipient has chosen to stop receiving marketing messages on WhatsApp from your business, so the message was not delivered. M...
Full explanation & fix → 131051 Action neededUnsupported message type
Unsupported message type, so WhatsApp would not send it. The type used is not among the message types WhatsApp accepts.
Full explanation & fix → 131052 PermanentCould not download the media the customer sent
The customer sent an image or a file over WhatsApp, but that media could not be downloaded, so the file is not available to you.
Full explanation & fix → 131053 Action neededThe message media could not be uploaded
The media used in the message could not be uploaded, so the message was not sent. Meta names an unsupported media type as one poss...
Full explanation & fix → 131057 TransientWhatsApp Business account is in maintenance mode
The message was not sent because your WhatsApp Business account is in maintenance mode. Meta names one possible reason for this: t...
Full explanation & fix → 131063 Action neededMarketing templates are disabled on Cloud API
The template you tried to send is categorised as Marketing, and marketing templates are currently switched off for your account on...
Full explanation & fix → 132000 Action neededTemplate variable count doesn't match the template
The number of template variables you sent doesn't match the approved template. Every variable the template defines must receive ex...
Full explanation & fix → 132001 Action neededTemplate missing in that language or not approved
The template doesn't exist in the language you sent it in, or it hasn't been approved yet. WhatsApp only sends templates that exis...
Full explanation & fix → 132005 Action neededTranslated template text is too long
The message was not sent because the translated text of this template is too long. WhatsApp does not accept a template whose trans...
Full explanation & fix → 132007 Action neededTemplate content violates a WhatsApp policy
The template violates WhatsApp's content policy, so WhatsApp will not send it. Templates are reviewed against WhatsApp's rules for...
Full explanation & fix → 132012 Action neededTemplate variable format is incorrect
A template variable's format doesn't match what the template expects. The values you sent were not in the format the approved temp...
Full explanation & fix → 132015 Action neededTemplate paused because of low quality
The template is paused and can't be used right now. WhatsApp paused it because its quality dropped too low, so no message built on...
Full explanation & fix → 132016 PermanentTemplate permanently disabled after repeated pauses
The template is disabled. It had been paused too many times for low quality, so WhatsApp has now disabled it permanently and it ca...
Full explanation & fix → 132068 Action neededMessage not sent — the Flow is blocked
The message was not sent because the Flow attached to it is in a blocked state. WhatsApp does not send messages that use a Flow wh...
Full explanation & fix → 132069 Action neededFlow throttled — 10 messages sent this hour
The Flow attached to this message is in a throttled state, and 10 messages using that Flow had already been sent in the last hour,...
Full explanation & fix → 133000 Action neededRegistration blocked by a failed earlier deregistration
The number could not be registered because an earlier attempt to deregister it failed. Until the number is deregistered cleanly, i...
Full explanation & fix → 133004 TransientWhatsApp servers are temporarily unavailable
The request did not go through because WhatsApp's servers were temporarily unavailable at that moment. This is on WhatsApp's side,...
Full explanation & fix → 133005 Action neededTwo-step verification PIN is incorrect
The two-step verification PIN that was submitted is not correct, so the request was refused. Two-step verification is switched on...
Full explanation & fix → 133006 Action neededPhone number must be verified before registering
The number was not registered because it has not been verified yet. WhatsApp requires the phone number to be verified before it ca...
Full explanation & fix → 133008 TransientToo many two-step verification PIN attempts
Too many wrong two-step verification PIN guesses were made for this number, so WhatsApp is refusing further attempts for a period...
Full explanation & fix → 133009 TransientTwo-step verification PIN entered too quickly
The two-step verification PIN was entered too quickly, so WhatsApp did not accept it. The details in the error show what to check...
Full explanation & fix → 133010 Action neededNumber not registered on the WhatsApp Business Platform
This phone number is not registered on the WhatsApp Business Platform, so the send did not go through. The number has to be regist...
Full explanation & fix → 133015 TransientNumber was recently deleted — deletion not finished
The number you are trying to register was deleted recently and the deletion has not completed yet. It cannot be registered again u...
Full explanation & fix → 134011 Action neededWhatsApp Payments terms not accepted yet
The message failed to send because acceptance of the WhatsApp Payments terms of service is still pending for this WhatsApp Busines...
Full explanation & fix → 135000 TransientMessage rejected for an unspecified reason
WhatsApp rejected the message because of an unknown problem with the details of what was sent, and Meta does not say which detail...
Full explanation & fix →Marketing Messages API errors
6Only marketing templates can be sent here
Your message was not delivered because this sending channel supports marketing template messages only. You may have sent a message...
Full explanation & fix → 132018 Action neededTemplate values rejected — message not sent
WhatsApp checked the template before sending and found a problem with the values filled into it. The message was not sent because...
Full explanation & fix → 134100 Action neededUtility or authentication template not accepted here
The template you tried to send is categorised as Utility or Authentication. Only templates categorised as Marketing can be sent on...
Full explanation & fix → 134101 TransientTemplate still syncing — try again shortly
The template you used was created recently and its syncing has not finished yet. Syncing can take up to 10 minutes, and a message...
Full explanation & fix → 134102 Action neededTemplate unavailable — check your eligibility
The template you tried to send is not available for use. Either its syncing with your ads could not be completed, or your business...
Full explanation & fix → 1752041 PermanentOnboarding already requested — nothing more to do
An onboarding request for this business was already submitted. Onboarding requests are limited to one per business customer, and o...
Full explanation & fix →Frequently asked questions
What does a WhatsApp error code mean?
Where do I find the error code in LetsBot?
Does every error mean something is wrong with my account?
Is this list complete and current?
Code not listed, or the fix did not work?
Send us the code and a screenshot and we will read it with you. If you send through LetsBot, the code appears next to the message with the reason it failed.