WhatsApp error codes
Look up the number Raion Hub shows next to a failed WhatsApp message and see what it means and what to do next.
When a WhatsApp message does not go through, Raion Hub shows a short reason and a number, for example 131026. The number comes from WhatsApp (Meta). In a campaign’s recipient list, or under a message in a conversation, click the number to land on its entry below. Most of these fix themselves or take one step.
Every message that fails reads Not delivered, with the reason beside it, for
example Marketing limit · 131049. The cause can be on your side (a limit, a
template, payment) or the person’s (not on WhatsApp, opted out), and each entry
below says which and what to do. Not sent is a different thing: a message Raion
Hub held back before it went out, such as a contact whose template variable had no
value. That has no WhatsApp number and is not on this page.
Type the number, or a word from the message, to narrow the list.
93 of 93 errors
Delivery to the person
- 470 Not delivered Outside the 24-hour reply window
What to do: Send a template message instead
Why it happens
An older WhatsApp code for the same thing as 131047: more than 24 hours have passed since the person last replied, so only a template message can be sent. Send an approved template instead.
An older code, no longer on Meta's list.
- 130403 Not delivered You have blocked this contact on WhatsApp
What to do: Unblock the contact to message them again
Why it happens, and Meta's wording
Your business blocked this person on WhatsApp, so nothing can be delivered to them. Do not retry. If the block was a mistake, unblock them in WhatsApp Manager and you can message them again.
Meta's wording: “Unable to deliver the message. This business has blocked the end user on WhatsApp”
- 130472 Not delivered Held back by a Meta experiment on this number
WhatsApp is running a marketing message experiment on your number, and this contact was in the group that is deliberately not sent the message. Nothing is wrong with your account. There is nothing to fix, and the contact can be messaged in a later campaign.
Meta's wording: “Message was not sent as part of an experiment”
- 131021 Not delivered Can't send to your own business number
What to do: Check the contact's number
Why it happens, and Meta's wording
The number you are messaging is the same as the WhatsApp number you send from. A number cannot message itself. Check the contact's phone number in Raion: it has probably been saved as your own number by mistake.
Meta's wording: “Sender and recipient phone number is the same”
- 131026 Not delivered Message undeliverable
What to do: Ask them to update WhatsApp, or reach them another way
Why it happens, and Meta's wording
WhatsApp accepted the message but could not hand it to this person. The usual causes are that the number is not on WhatsApp, the person has not accepted WhatsApp's latest terms, or they are on a very old version of the app. It does not always mean the number is wrong. If you can reach them another way, ask them to open WhatsApp, accept any prompt and update the app, then send again.
Meta's wording: “Unable to deliver message”
- 131047 Not delivered Outside the 24-hour reply window
What to do: Send a template message instead
Why it happens, and Meta's wording
WhatsApp only lets you send a free-form message within 24 hours of the person's last reply. After that, only an approved template message gets through. Send a template to start the conversation again; once they reply, the 24 hours start over.
Meta's wording: “More than 24 hours have passed since the recipient last replied to the sender number”
- 131049 Not delivered Held back by WhatsApp's marketing limit
What to do: Wait at least 24 hours before messaging this contact again
Why it happens, and Meta's wording
WhatsApp limits how many marketing messages one person receives from all businesses, to keep chats useful. When this person has hit their limit, WhatsApp holds your message back. It is not a problem with your number or template. Wait at least 24 hours and try again; Raion also retries automatically where it can.
Meta's wording: “This message was not delivered to maintain healthy ecosystem engagement”
- 131050 Not delivered Contact has opted out of marketing messages
This person chose to stop receiving marketing messages from your business on WhatsApp, so the message was not delivered. Do not keep retrying: it will never arrive. You can still send them service or utility messages they ask for. Mark them as opted out in Raion so future campaigns skip them.
Meta's wording: “Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business”
- 131051 Not delivered Unsupported message type
WhatsApp does not support the kind of message that was sent, for example a file format or message type it cannot show. Send the content in a supported form, such as plain text, an image, a PDF or an approved template.
Meta's wording: “Unsupported message type”
Limits and pacing
- 4 Not delivered Too many requests from Raion's connection
What to do: Try again later
Why it happens, and Meta's wording
The connection between Raion and WhatsApp has made too many requests in a short time, so WhatsApp asked it to slow down. This clears by itself. Raion retries automatically; if you retry by hand, wait a few minutes first.
Meta's wording: “The app has reached its API call rate limit”
- 80007 Not delivered Your WhatsApp account hit its request limit
What to do: Try again later
Why it happens, and Meta's wording
Your WhatsApp Business account has reached its request limit for now, so WhatsApp paused it. This clears by itself. Wait a little and try again, or spread a big campaign over a longer time.
Meta's wording: “The WhatsApp Business Account has reached its rate limit”
- 130429 Not delivered Your number hit its sending speed limit
What to do: Try again later
Why it happens, and Meta's wording
Your number reached the most messages WhatsApp lets it send per second. Messages are not lost: they need to be sent more slowly. Raion retries automatically. For very large campaigns, schedule them so the sends are spread out.
Meta's wording: “Cloud API message throughput has been reached”
- 131048 Not delivered Number limited after blocks or spam reports
What to do: Check your number's quality in Meta, then try later
Why it happens, and Meta's wording
WhatsApp has limited how many messages this number can send, usually because too many earlier messages were blocked or reported as spam. Look at the number's quality rating in WhatsApp Manager. Sending resumes when the quality recovers; sending fewer, more relevant messages helps it.
Meta's wording: “Message failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam”
- 131056 Not delivered Too many messages to this person at once
What to do: Try again later
Why it happens, and Meta's wording
You sent this person too many messages in a short time. Wait a while and try again; messages to other people are not affected. If you meant to send several messages in a row, space them out.
Meta's wording: “Too many messages sent from the sender phone number to the same recipient phone number in a short period of time”
- 131064 Not delivered Sending limit hit by template categories
What to do: Check your template categories in Meta
Why it happens, and Meta's wording
WhatsApp has limited your account because some templates were put in a category that does not match their content, for example marketing wording in a utility template. Review the categories of your templates. The limit lifts by itself when the enforcement period ends.
Meta's wording: “Message failed to send because this account has reached its messaging limit due to template classification violations. This applies to both template messages and direct send messages”
- 133016 Not delivered Too many number setup attempts
What to do: Wait, then try connecting again
Why it happens, and Meta's wording
The number was registered or removed too many times in a short period, so WhatsApp has blocked further attempts for a while. Wait until the block ends, then try connecting the number again, once.
Meta's wording: “Registration or Deregistration failed because there were too many attempts for this phone number in a short period of time”
Account and payment
- 33 Not delivered WhatsApp number was deleted
What to do: Reconnect a valid number in Integrations
Why it happens, and Meta's wording
The WhatsApp number Raion sends from has been deleted. Reconnect a number that exists in Integrations.
Meta's wording: “The business phone number has been deleted”
- 368 Not delivered WhatsApp account restricted or disabled
What to do: Check the account in Meta Business Manager
Why it happens, and Meta's wording
WhatsApp restricted or disabled your business account for breaking a platform policy. Open Meta Business Manager, read the policy notice and follow the steps to appeal or fix it. Sending stays off until Meta lifts it.
Meta's wording: “The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy”
- 130497 Not delivered Can't message people in this country
What to do: Check the number's status in Meta Business Manager
Why it happens, and Meta's wording
Your account is not allowed to message people in this country, as set by WhatsApp's policy for your business type. Check Meta's messaging policy for the allowed countries. Messages to other countries are not affected.
Meta's wording: “The WhatsApp Business Account is restricted from messaging to users in certain countries”
- 131031 Not delivered Your WhatsApp account is restricted
What to do: Check the number's status in Meta Business Manager
Why it happens, and Meta's wording
WhatsApp has restricted or locked your WhatsApp Business account, usually for a policy problem. In rarer cases a check on a security PIN failed. Open Meta Business Manager and read the account status for what to fix; Raion cannot lift a restriction for you.
Meta's wording: “The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy, or we were unable to verify data included in the request against data set on the WhatsApp Business Account (e.g, the two-step pin included in the request is incorrect)”
- 131037 Not delivered WhatsApp number has no approved name
What to do: Get the display name approved in Meta
Why it happens, and Meta's wording
Your WhatsApp number does not have an approved display name yet, so WhatsApp blocks sending from it. Check the display name request in Meta Business Manager and finish or fix it. Sending works again once the name is approved.
Meta's wording: “The 555 business phone number used to send the request does not have an approved display name”
- 131042 Not delivered Payment issue on the WhatsApp account
What to do: Check your payment method in Meta, then retry
Why it happens, and Meta's wording
WhatsApp cannot charge for sending, so it blocks every message from this number until billing is fixed. Common causes: no payment method attached, a credit line over its limit or not active, or a currency or timezone not set. Fix it in your Meta Business portfolio billing settings, then retry the failed messages.
Meta's wording: “There was an error related to your payment method”
- 131045 Not delivered WhatsApp number not registered
What to do: Reconnect the number in Integrations
Why it happens, and Meta's wording
The number is not fully registered with WhatsApp, so it cannot send. Reconnect it in Integrations to finish the setup, then retry.
Meta's wording: “Message failed to send due to a phone number registration error”
- 131057 Not delivered WhatsApp account in maintenance
What to do: Try again in a few minutes
Why it happens, and Meta's wording
Your WhatsApp account is briefly in maintenance, for example while WhatsApp upgrades how many messages it can send. This passes by itself. Try again in a few minutes.
Meta's wording: “Business Account is in maintenance mode”
- 131063 Not delivered Marketing templates switched off
What to do: Switch marketing templates back on in Meta
Why it happens, and Meta's wording
Marketing templates are turned off for this account's regular sending setup, so a marketing template was refused. Turn marketing messages back on for the number, or send a utility template instead.
Meta's wording: “Your template is categorized as Marketing, but marketing templates are currently disabled for your Cloud API configuration”
- 134011 Not delivered WhatsApp Payments terms not accepted
What to do: Accept the terms in Meta Business Manager
Why it happens, and Meta's wording
WhatsApp is waiting for your business to accept its Payments terms of service before it will send. Accept the terms in Meta Business Manager, then try again.
Meta's wording: “Message failed to send because WhatsApp Payments terms of service acceptance is pending for this WhatsApp Business Account”
Templates
- 131008 Not delivered Template is missing a required value
What to do: Check the template in Templates
Why it happens, and Meta's wording
A required piece of information was missing when the message was built. Open the template in Templates and check it is complete, then send again. If it keeps happening, contact support.
Meta's wording: “The request is missing a required parameter”
- 131009 Not delivered A value in the message was not accepted
What to do: Check the template in Templates
Why it happens, and Meta's wording
One of the values sent with the message was not accepted, such as a phone number or a template detail. Check the contact's phone number and the template, then try again. If you just created the template, wait ten minutes and retry.
Meta's wording: “One or more parameter values are invalid”
- 131055 Not delivered Message type not allowed
What to do: Use a marketing template
Why it happens, and Meta's wording
This sending route only accepts marketing template messages, and something else was sent. Use a template in the Marketing category.
Meta's wording: “(#131055) Method not allowed”
- 132000 Not delivered Template variables not all filled in
What to do: Check the template in Templates
Why it happens, and Meta's wording
The template has variables, like a name or date, and the message did not fill in all of them. Make sure every contact has a value for each field the template uses, then retry.
Meta's wording: “The number of variable parameter values included in the request did not match the number of variable parameters defined in the template”
- 132001 Not delivered Template not approved or not in that language
What to do: Check the template in Templates
Why it happens, and Meta's wording
WhatsApp could not find this template in the language it was sent in, or it is not approved yet. Check the template's status and language in Templates; send once it shows Approved.
Meta's wording: “The template does not exist in the specified language or the template has not been approved”
- 132002 Not delivered Template details rejected by WhatsApp
What to do: Check the template in Templates
Why it happens
WhatsApp rejected the template details sent with this message. Open the template in Templates and check it, then try again.
An older code, no longer on Meta's list.
- 132005 Not delivered Template text too long after translation
What to do: Check the template in Templates
Why it happens, and Meta's wording
The text became too long once a translation was applied. Shorten the template or the values filled into it, then send again.
Meta's wording: “Translated text is too long”
- 132007 Not delivered Template wording breaks a WhatsApp policy
What to do: Check the template in Templates
Why it happens, and Meta's wording
WhatsApp says the template wording breaks one of its policies. Review the template against WhatsApp's template rules, edit it and submit it for review again.
Meta's wording: “Template content violates a WhatsApp policy”
- 132012 Not delivered A template value is in the wrong format
What to do: Check the template in Templates
Why it happens, and Meta's wording
A value filled into the template is not in the format the template expects, for example text where a number is needed. Check the contact's field values and the template, then retry.
Meta's wording: “Variable parameter values formatted incorrectly”
- 132015 Not delivered Template paused for low quality
What to do: Edit the template and resubmit it
Why it happens, and Meta's wording
WhatsApp paused this template because people reported it or blocked after receiving it. It cannot be sent while paused. Edit it to improve the wording and wait for approval, or use a different template.
Meta's wording: “Template is paused due to low quality so it cannot be sent in a template message”
- 132016 Not delivered Template permanently disabled
What to do: Create a new template
Why it happens, and Meta's wording
This template was paused for low quality too many times, so WhatsApp disabled it for good. Create a new template with different content and use that instead.
Meta's wording: “Template has been paused too many times due to low quality and is now permanently disabled”
- 132018 Not delivered Template details not accepted
What to do: Check the template in Templates
Why it happens, and Meta's wording
There is a problem with the values filled into this marketing template. Review the template's variables, fix them and send again.
Meta's wording: “(#132018) Template validation error”
- 132068 Not delivered WhatsApp Flow is blocked
What to do: Fix the Flow in Meta, then retry
Why it happens, and Meta's wording
The WhatsApp Flow attached to this message is blocked, so the message cannot go out. Fix the Flow in WhatsApp Manager, then send again.
Meta's wording: “Flow is in blocked state”
- 132069 Not delivered WhatsApp Flow is paused for now
What to do: Fix the Flow in Meta, then retry
Why it happens, and Meta's wording
The WhatsApp Flow was used too often in the last hour and has been paused. Fix any problems with the Flow in WhatsApp Manager, then try again later.
Meta's wording: “Flow is in throttled state and 10 messages using this flow were already sent in the last hour”
- 134100 Not delivered Only marketing templates allowed here
What to do: Use a marketing template
Why it happens, and Meta's wording
This sending route only accepts templates in the Marketing category. The template used is a utility or authentication one. Use a marketing template instead.
Meta's wording: “(#134100) Only marketing messages supported”
- 134101 Not delivered Template still syncing
What to do: Wait ten minutes and try again
Why it happens, and Meta's wording
A newly created marketing template needs up to ten minutes before it can be sent this way. Wait a little and try again.
Meta's wording: “(#134101) Your template is still syncing”
- 134102 Not delivered Template not available for use
What to do: Try later, or contact support
Why it happens, and Meta's wording
The template could not finish syncing, or the account is not set up for this sending route. Try again later. If it still fails, contact support.
Meta's wording: “(#134102) Template unavailable for use”
- 2388019 Not delivered Template limit reached
What to do: Delete templates you no longer use
Why it happens, and Meta's wording
A WhatsApp Business account can hold up to 250 templates, and yours is full. Delete templates you no longer use in Templates, then create the new one.
Meta's wording: “Message Template Limit Exceeded”
- 2388039 Not delivered Template can't be edited right now
What to do: Wait until the review finishes
Why it happens, and Meta's wording
A template cannot be changed while it is waiting for review, and templates have a daily limit on edits. Wait for WhatsApp to approve or reject it, then edit again.
Meta's wording: “Message template status can’t be changed”
- 2388040 Not delivered Template text too long
What to do: Shorten the text and save again
Why it happens, and Meta's wording
Part of the template is longer than WhatsApp allows. Shorten the header, body, footer or button text, then save again. The error message names the part that is too long.
Meta's wording: “Character limit exceeded”
- 2388047 Not delivered Template header format not accepted
What to do: Fix the header and save again
Why it happens, and Meta's wording
The template's header has formatting WhatsApp does not accept. Simplify the header text, remove unusual characters or extra variables, and save again.
Meta's wording: “Message header format is incorrect”
- 2388072 Not delivered Template body format not accepted
What to do: Fix the body and save again
Why it happens, and Meta's wording
The template's main text has formatting WhatsApp does not accept, for example too many line breaks or a stray bracket. Simplify the body and save again.
Meta's wording: “Message body format is incorrect”
- 2388073 Not delivered Template footer format not accepted
What to do: Fix the footer and save again
Why it happens, and Meta's wording
The template's footer has formatting WhatsApp does not accept. Footers must be plain, short text with no variables. Simplify it and save again.
Meta's wording: “Message footer format is incorrect”
- 2388293 Not delivered Too many variables for the text length
What to do: Add more text or remove a variable
Why it happens, and Meta's wording
The template has too many variables compared with how much fixed text it has. Add more wording around the variables or remove some, then save again.
Meta's wording: “Parameters words ratio exceeds limit”
- 2388299 Not delivered Variable at the start or end of the text
What to do: Move the variable inside the sentence
Why it happens, and Meta's wording
WhatsApp does not allow a variable as the very first or very last thing in a template. Put a word or punctuation before and after it, then save again.
Meta's wording: “Leading or trailing parameters not allowed”
Media
- 1014 Not delivered Media couldn't be sent
What to do: Check the file and try again
Why it happens
The file attached to this message could not be used. Check that it is a supported type and not too large, then send again.
An older code, no longer on Meta's list.
- 131017 Not delivered Media couldn't be sent
What to do: Check the file and try again
Why it happens
The file attached to this message could not be used. Check that it is a supported type and not too large, then send again.
An older code, no longer on Meta's list.
- 131018 Not delivered Media couldn't be sent
What to do: Check the file and try again
Why it happens
The file attached to this message could not be used. Check that it is a supported type and not too large, then send again.
An older code, no longer on Meta's list.
- 131020 Not delivered Media couldn't be sent
What to do: Check the file and try again
Why it happens
The file attached to this message could not be used. Check that it is a supported type and not too large, then send again.
An older code, no longer on Meta's list.
- 131052 Not delivered Couldn't download the customer's media
What to do: Ask them to send it another way
Why it happens, and Meta's wording
A file the person sent could not be downloaded to Raion. Ask them to send it again, or by another route such as email.
Meta's wording: “Unable to download the media sent by the user”
- 131053 Not delivered WhatsApp could not take the file
What to do: Check the file and try again
Why it happens, and Meta's wording
WhatsApp could not take the file you attached, most often because the format is not supported or the file is too large. Check the file type and size, then send again.
Meta's wording: “Unable to upload the media used in the message”
Connection and access
- 0 Not delivered WhatsApp connection expired
What to do: Reconnect the number in Integrations
Why it happens, and Meta's wording
WhatsApp could not confirm who Raion is acting for. The access you gave has expired or was removed in Meta settings. Reconnect your number in Integrations to give access again.
Meta's wording: “We were unable to authenticate the app user”
- 3 Not delivered WhatsApp permission missing
What to do: Reconnect the number in Integrations
Why it happens, and Meta's wording
WhatsApp says the connection is missing a permission it needs for this action. Reconnect your number in Integrations and accept every permission on Meta's screens.
Meta's wording: “Capability or permissions issue”
- 10 Not delivered WhatsApp permission not granted
What to do: Reconnect the number in Integrations
Why it happens, and Meta's wording
A permission needed for this action was never granted or has been taken away. Reconnect your number in Integrations and accept every permission. If it still fails, the feature may not be available to your account yet.
Meta's wording: “Permission is either not granted or has been removed”
- 190 Not delivered WhatsApp access has expired
What to do: Reconnect the number in Integrations
Why it happens, and Meta's wording
The access Raion holds for your WhatsApp account has expired. This happens after a password change or when access is removed in Meta settings. Reconnect the number in Integrations; no messages are lost, but sending stops until you do.
Meta's wording: “Your access token has expired”
- 200 Not delivered WhatsApp did not accept the connection
What to do: Reconnect the number in Integrations
Why it happens, and Meta's wording
WhatsApp did not accept the connection's access. Reconnect the number in Integrations and try again.
Meta's wording: “No access token was provided. The API returns the message “Provide valid app ID”. This error occurs on certain GET endpoints (such as whatsapp_business_profile) when no token is included. Other endpoints may return error code 190 or 104 instead”
- 200-299 Not delivered A WhatsApp permission is missing
What to do: Reconnect the number in Integrations
Why it happens, and Meta's wording
Codes from 200 to 299 mean a permission is missing or has been removed. Reconnect the number in Integrations and accept every permission.
Meta's wording: “Permission is either not granted or has been removed”
- 131005 Not delivered A WhatsApp permission is missing
What to do: Reconnect the number in Integrations
Why it happens, and Meta's wording
WhatsApp says a permission needed to send was removed or never granted. Reconnect the number in Integrations and accept every permission.
Meta's wording: “Permission is either not granted or has been removed”
Phone number setup
- 133000 Not delivered Earlier removal of the number failed
What to do: Remove the number again, then reconnect
Why it happens, and Meta's wording
A previous attempt to remove this number did not finish. Remove it again before connecting it.
Meta's wording: “A previous deregistration attempt failed”
- 133005 Not delivered Two-step PIN is wrong
What to do: Check the PIN, or reset it in WhatsApp
Why it happens, and Meta's wording
The two-step verification PIN entered does not match the one on the number. Check it, or turn two-step verification off and set a new PIN.
Meta's wording: “Two-step verification PIN incorrect”
- 133006 Not delivered Number needs verifying first
What to do: Verify the number, then connect it
Why it happens, and Meta's wording
The number has to be verified before it can be registered. Verify it, then connect it again.
Meta's wording: “Phone number needs to be verified before registering”
- 133008 Not delivered Too many wrong PIN guesses
What to do: Wait, then try again
Why it happens, and Meta's wording
The two-step PIN was entered wrongly too many times. Wait for the time shown in the error, then try again.
Meta's wording: “Too many two-step verification PIN guesses for this phone number”
- 133009 Not delivered PIN was entered too quickly
What to do: Wait a moment, then try again
Why it happens, and Meta's wording
The PIN was tried again too soon after the last attempt. Wait a moment, then try again.
Meta's wording: “Two-step verification PIN was entered too quickly”
- 133010 Not delivered Number isn't registered with WhatsApp
What to do: Reconnect the number in Integrations
Why it happens, and Meta's wording
This number has not been registered for the WhatsApp Business Platform yet. Reconnect it in Integrations to register it, then try again.
Meta's wording: “Phone number not registered on the WhatsApp Business Platform”
- 133015 Not delivered Number was deleted a moment ago
What to do: Wait 5 minutes, then try again
Why it happens, and Meta's wording
The number was just deleted and WhatsApp has not finished clearing it. Wait five minutes, then try to connect it again.
Meta's wording: “The phone number you are attempting to register was recently deleted, and deletion has not yet completed”
- 2388012 Not delivered Number is already on the account
What to do: Use a different number
Why it happens, and Meta's wording
The number you are moving is already part of this WhatsApp account. Use a number that is not already there.
Meta's wording: “This phone number already exists in your list of phone numbers”
- 2388091 Not delivered Number can't get a verification code
What to do: Register and verify the number instead
Why it happens, and Meta's wording
This number is not being moved from another account, so code verification is not available for it. Register and verify the number the normal way.
Meta's wording: “This phone number isn’t eligible to receive/verify a registration code since it is not being migrated”
- 2388093 Not delivered Number can't get a verification code
What to do: Register and verify the number instead
Why it happens, and Meta's wording
This number is not being moved from another account, so code verification is not available for it. Register and verify the number the normal way.
Meta's wording: “This phone number isn’t eligible to receive/verify a registration code since it is not being migrated”
- 2388103 Not delivered Number can't be moved
What to do: Add the number directly instead
Why it happens, and Meta's wording
WhatsApp could not move this number. In most cases the number can simply be added directly instead. If the display name is not approved yet, get it approved first. If a generic error appears, wait and retry, then contact support.
Meta's wording: “Cannot migrate phone number”
- 2494100 Not delivered Number is in maintenance
What to do: Try again in a few minutes
Why it happens, and Meta's wording
The WhatsApp number is briefly in maintenance. Try again in a few minutes.
Meta's wording: “Account is in maintenance mode”
Other and temporary errors
- 1 Not delivered WhatsApp returned a general error
What to do: Try again
Why it happens, and Meta's wording
WhatsApp returned a general error, which is often a short outage on their side. Try again in a few minutes. If it keeps happening, contact support with this code.
Meta's wording: “Invalid request or possible server error”
- 2 Not delivered WhatsApp is temporarily unavailable
What to do: Try again in a few minutes
Why it happens, and Meta's wording
WhatsApp is briefly down or overloaded. This passes by itself. Try again in a few minutes.
Meta's wording: “Temporary due to downtime or due to being overloaded”
- 100 Not delivered WhatsApp did not accept the request
What to do: Check the message details and try again
Why it happens, and Meta's wording
WhatsApp refused the request because something in it was not understood, such as a wrong value or a field that is too long. Check the contact's number and the message, then retry. If it keeps happening, contact support with this code.
Meta's wording: “The request included one or more unsupported or misspelled parameters”
- 131000 Not delivered WhatsApp failed without giving a reason
What to do: Try again
Why it happens, and Meta's wording
WhatsApp failed for a reason it did not explain. Try again. If it keeps happening for the same contact, contact support with this code.
Meta's wording: “Message failed to send due to an unknown error”
- 131001 Not delivered Temporary WhatsApp error
What to do: Try again
Why it happens
WhatsApp had a short problem handling the message. Try again.
An older code, no longer on Meta's list.
- 131002 Not delivered Temporary WhatsApp error
What to do: Try again
Why it happens
WhatsApp had a short problem handling the message. Try again.
An older code, no longer on Meta's list.
- 131016 Not delivered A WhatsApp service is briefly down
What to do: Try again
Why it happens, and Meta's wording
A WhatsApp service is briefly unavailable. Try again in a few minutes.
Meta's wording: “A service is temporarily unavailable”
- 133004 Not delivered WhatsApp is temporarily unavailable
What to do: Try again in a few minutes
Why it happens, and Meta's wording
A WhatsApp server is briefly unavailable. Try again in a few minutes.
Meta's wording: “Server is temporarily unavailable”
- 135000 Not delivered WhatsApp did not accept the message
What to do: Try again, or contact support
Why it happens, and Meta's wording
WhatsApp rejected the message for a reason it did not explain. Try again. If it keeps happening, contact support with this code.
Meta's wording: “Message failed to send because of an unknown error with your request parameters”
- 200005 Not delivered Template insights unavailable
Template analytics are not available for this account yet. Nothing is wrong with your messages.
Meta's wording: “Template insights unavailable”
- 200006 Not delivered Template insights can't be turned off
Once template analytics are on for an account, WhatsApp does not allow them to be turned off again.
Meta's wording: “Cannot disable template insights”
- 200007 Not delivered Template insights are off
What to do: Turn on template analytics in Meta
Why it happens, and Meta's wording
Template analytics have not been turned on for this account. Turn them on in WhatsApp Manager to see them.
Meta's wording: “Template Insights not enabled”
- 1752041 Not delivered Already invited to connect
This business has already been invited to connect by another partner, and only one invitation is allowed. Nothing more is needed: the invitation already covers all of the business's eligible WhatsApp accounts.
Meta's wording: “(#1752041) Duplicate Request”
- 2593079 Not delivered Account already marked for migration
What to do: Contact support
Why it happens, and Meta's wording
This account is already flagged for a move to a different setup, which cannot be repeated. Contact support.
Meta's wording: “This WABA has already been marked for migration to a different solution ID”
- 2593085 Not delivered Account can't be transferred this way
What to do: Contact support
Why it happens, and Meta's wording
This account is not eligible for the ownership transfer that was tried. Contact support.
Meta's wording: “Invalid WhatsApp Business Account for OBO Mobility”
- 2593107 Not delivered Contact import already used
What to do: Contact support to start over
Why it happens, and Meta's wording
A number's contacts and chat history can only be synced once. That has already been used. Contact support to start again.
Meta's wording: “You have exceeded the maximum number of times to call the synchronization api for this phone number”
- 2593108 Not delivered Import window has closed
What to do: Contact support to start over
Why it happens, and Meta's wording
Contacts and chat history can only be brought over within 24 hours of connecting. That time has passed. Contact support to start again.
Meta's wording: “Synchronization request can only be made within 24 hours of onboarding”
Where this list comes from
It follows Meta’s own list of WhatsApp error codes , rewritten in plain words. Meta’s page is the final word when the two differ. Checked against Meta’s page on 28 October 2026. If a code is not here yet, Raion Hub still shows WhatsApp’s own wording for it.
Stuck on one? Contact us and quote the number.
- Find out why someone did not get your campaignSee why each person did not get your campaign, then fix and retry the ones you can.
- When something goes wrongUse On this page to jump to the heading that matches your screen, then follow the one thing to do next.
whatsapp error code, error code, error 131026, error 131047, error 131049, error 131042, error 131050, error 130429, 131026 undeliverable, message undeliverable, message failed, failed to send, not delivered, couldn't send, 24 hour window, re-engagement, rate limit, template paused, meta error, error number, what does error mean
Didn't find it on this page? Email us and the reply starts from the page you were on.
Email support