Meta Error Code
Throttling error
Code
Details
Possible causes and solutions
HTTP status code
4
Too many API calls
This app has reached its API call traffic limit.
InApp Dashboardload this app, then check theApp Rate Limitssection to confirm whether this app has reached itsrate limits. If it has, try again later or reduce how often or how many API queries this app makes.
400Bad request
80007
Rate limit issue
The WhatsApp Business account has reached its rate limit.
See the WhatsApp Business accountrate limits. Try again later; or reduce how often or how many API queries this app makes.
400Bad request
130429
Throughput reached
Cloud API message throughput reached.
This app has reached the API throughput limit. SeeThroughput. Try again later; or reduce how frequently this app sends messages.
400Bad request
131048
Spam rate limit reached
This phone number is limited in how many messages it can send, so message sending failed. This can be because too many messages were previously blocked or marked as spam.
Check your quality status in the WhatsApp Manager. SeeTemplate limitsandTemplate quality.
400Bad request
131056
Pairing rate limit reached (business account, consumer account)
Too many messages were sent in a short time from the sender phone number to the same recipient phone number.
If you need to send messages to the same phone number, wait and retry the operation. You can still send messages to other numbers without waiting
400Bad request
133016
Exceeded account registration/unregistration attempt limit
Failed to successfully register or unregister this phone number due to too many attempts in a short period.
This business phone number was blocked for reaching the maximum number of registration/unregistration attempts. After the number is unblocked, try again. See theRegistrationdocumentation's "Limits" section.
400Bad request
Other errors
Code
Details
Possible causes and solutions
HTTP status code
130472
User's number involved in an experiment
The message was not sent as part of anexperiment.
400Bad request
131000
errored
An unknown error occurred, so message sending failed.
Try again. If the error persists, create adirect supportticket. For WhatsApp Flows that use the endpoint - whenSetting the business public keythe signature cannot be computed or the GraphQL endpoint cannot be called, or the GraphQL endpoint returns an error.
500Internal server error
131005
Access denied
Permission not granted or permission removed.
Use theAccess Token Debuggerto confirm whether your app has the permissions required by the endpoint. SeeAuthentication and authorization errors.
403Forbidden
131008
Required parameter missing
A required parameter is missing from the request.
See the endpoint reference docs to determine which parameters are required.
400Bad request
131009
Invalid parameter value
One or more parameter values are invalid.
See the reference docs for this endpoint to determine which values each parameter supports; seePhone numbersto learn how to add phone numbers to a WhatsApp Business account.
400Bad request
131016
Service unavailable
Service temporarily unavailable.
Visit the WhatsApp Business Platform Statuspage to view API status information, then try again.
500Internal server error
131021
Recipient cannot be the sender
Sender and recipient phone numbers are the same.
Send the message to a phone number different from the sender.
400Bad request
131026
Message undeliverable
The message could not be delivered. Reasons may include:
The recipient's phone number is not a WhatsApp number.
The recipient has not accepted our new Terms of Service and Privacy Policy.
The recipient is using an old version of WhatsApp; they must use the following WhatsApp versions or newer:
Android: 2.21.15.15
SMBA: 2.21.15.15
iOS: 2.21.170.4
SMBI: 2.21.170.4
KaiOS: 2.2130.10
Web: 2.2132.6
If using a non‑WhatsApp contact method, ask the WhatsApp user to:
Confirm they can actually send messages to your WhatsApp Business phone number.
Confirm they have accepted our latest Terms of Service (if they haven't yet accepted, the system will prompt them to accept the latest terms/policies inSettings > Helpor inSettings > App Info).
Update to the latest WhatsApp client.
400Bad request
131037
Phone numbers provided by WhatsApp require an approved display name before messages can be sent.
The 555 business phone numberused to send the request does not have an approveddisplay name.
for the 555 business phone number. Also see our Help Center articledisplay nameHow to change your WhatsApp Business display namefor instructions.article.
400Bad request
131042
Business payment eligibility issue
There is an issue with your payment method.
See Billing overview for WhatsApp Business accountto confirm whether you have set up billing correctly. Common issues:
WhatsApp Business account not linked to a payment account
Quota exceeded
Quota not set or enabled (payment account)
WhatsApp Business account deleted
WhatsApp Business account deactivated
Timezone not set
Currency not set
MessagingFor request (on behalf) pending or denied
400Bad request
131045
Incorrect certificate
Message sending failed because of a phone number registration error.
Register the phone numberand then retry.
500Internal server error
131047
Re‑engagement message
More than 24 hours have passed since the recipient last replied to the sender number.
Instead, send the recipient atemplate message.
400Bad request
131049
Meta chose not to deliver.
To maintain a healthy ecosystem, this message was not delivered.
If you receive this error code and suspect it is due to this restriction, wait at least 24 hours before resending a template message. Because this restriction can be enforced at varying times, resending immediately will likely result in another error response. SeeMarketing template message limit per user.
400Bad request
131050
User opted out of marketing messages.
Message undeliverable. The recipient has chosen to stop receiving marketing messages from businesses via WhatsApp.
Do not attempt to send messages to this user again, because they will not receive them. To be notified whenever a WhatsApp user stops or resumes receiving marketing template messages from you, subscribe to user_preferences webhook.
400Bad request
131051
Message type not supported
Message type not supported.
SeeMessageto learn about supported message types, then retry using a supported message type.
400Bad request
131052
Error downloading media
Unable to download media sent by the user.
We cannot download the media included in the message sent by this WhatsApp user. For details, see anyMessage value in the Webhook that was triggered when the message was received. error.error_data.details Have the WhatsApp user send the media file to you using a non‑WhatsApp method.
400Bad request
131053
Error uploading media
Unable to upload the media used in the message.
We couldn't upload the media for one or more reasons (for example, unsupported media type). For details, see anyMessage value in the Webhook that was triggered when the message was received. error.error_data.details values triggered when message sending failed. We recommend checking any media files that caused the error and confirming those files are actually supported. For example, on UNIX you can check a file's MIME type from the command line using:file -I rejected-file.movThen you can confirm whether its MIME type is supported. SeeSupported media types.
400Bad request
131057
Account in maintenance mode
Business account in maintenance mode
The WhatsApp Business account is currently in maintenance mode. One possible reason is that the account is undergoing anThroughputupgrade.
500Bad request
132000
Template parameter count mismatch
The number of variable parameter values included in the request does not match the number of variables defined in the template.
See ourTemplatesdocumentation to learn about parameters, and ensure the request includes all parameter values the template requires.
400Bad request
132001
Template does not exist
The template does not exist in the specified language or has not yet been approved.
Ensure your template is approved and that the template name and language settings are correct. See ourTemplatesdocumentation for details about templates.
404Not found
132005
Template filler text too long
Translated text too long.
Check WhatsApp Manager to confirm the template has been translated. See ourTemplate qualitydocumentation to learn how to check template status.
400Bad request
132007
Violation of template formatting character policy
Template content violates WhatsApp policies.
See ourTemplate reviewdocumentation to learn possible reasons for violations.
400Bad request
132012
Template parameter format mismatch
Variable parameter values have incorrect format.
The variable parameter values included in the request do not use the format specified in the template. See ourTemplatesdocumentation for details about template parameters and formatting.
400Bad request
132015
Template suspended
The template was suspended due tolow qualityso you cannot send this template in a template message.
Edit the templateto improve its quality, and retry after the template is approved.
400Bad request
132016
Template disabled
The template has been suspended multiple times forlow qualityand is now permanently disabled.
Create a new template with different content.
400Bad request
132068
Flows blocked
Flows are in a blocked state.
Correct Flows
400Bad request
132069
Flows throttled
Flows are throttled; 10 messages using this Flow have been sent in the past hour.
Correct Flows
400Bad request
133000
Unregistration incomplete
A previous unregistration attempt failed.
Reunregisterthe number and thenRegistration.
500Internal server error
133004
Server temporarily unavailable
Server temporarily unavailable.
Visit the WhatsApp Business Platform Statuspage to view API status info, check the details value in the response, and then try again.
503Service unavailable
133005
Two‑step verification PIN mismatch
Two‑step verification PIN is incorrect.
Confirm the two‑step verification PIN included in the request is correct. To reset the PIN, disable two‑step verification, then set a new PIN. SeeTwo‑step verification.
400Bad request
133006
Phone number needs re‑verification
The phone number must be verified before registration.
400Bad request
133008
Two‑step verification PIN attempts exceeded
Too many two‑step verification PIN attempts for this phone number.
In details Retry after the time specified in the response value.
400Bad request
133009
Two‑step verification PIN attempts too fast
Two‑step verification PIN entered too quickly.
Check the details response value, then try again.
400Invalid request
133010
Phone number not registered
The phone number is not registered on the WhatsApp Business Platform.
Register the phone numberand then retry.
400Invalid request
133015
Wait a few minutes and then try registering the phone number again
The phone number you are currently trying to register was recently deleted but deletion is not yet complete.
Wait 5 minutes and then retry the request.
400Invalid request
134011
Has not accepted WhatsApp payment terms
Message sending failed because this WhatsApp Business account is awaiting acceptance of WhatsApp payment terms.
Accept the WhatsApp payment terms using the link provided in the error message, then retry.
400Invalid request
135000
General user error
There was an unknown error in your request parameters, so message sending failed.
See thereference docsfor this endpoint to confirm the syntax you used to query the endpoint is correct. If you continue to receive this error code in responses, contactCustomer Support.
WhatsApp Marketing Messages API error codes
The WhatsApp Marketing Messages API uses the same error codes as the Cloud API and adds some additional error codes listed below.
Code
Message
Details
Possible causes and solutions
HTTP status code
100
(#100) Invalid parameter
Message must be a template message.
You are attempting to send a non‑template message. Message type must be template. Please retry using a marketing template.
400 Bad Request
131009
(#131009) Parameter value is not valid
One or more parameter values are invalid.
A parameter you used may be invalid. Confirm you are usingvalid parametersand then retry. Ad sync may not be complete. Wait 10 minutes and try again. If the problem persists, contact support.
400 Bad Request
131055
(#131055) Method not allowed
Only marketing template messages are supported
You might be attempting to send a non‑template message or an authentication or utility template. Try sending again using a marketing template message.
400 Bad Request
134100
(#134100) Only marketing messages supported
You're only able to send marketing messages on this API.
Will be launched in Graph API v23.0.You are attempting to send utility or authentication templates. Only MARKETING class templates are supported.
400 Bad Request
134101
(#134101) Your template is still syncing
When you send a message from a template, the template syncing process can take up to 10 minutes to complete. Wait a few minutes, and then try sending your message again.
Will be launched in Graph API v23.0.You are attempting to send a newly created template whose ad sync has not completed. Ad sync can take up to 10 minutes. Wait 10 minutes and try again.
400 Bad Request
134102
(#134102) Template unavailable for use
Please check your eligibility status to ensure you are onboarded (/documentation/business-messaging/whatsapp/marketing-messages/onboarding#ensure-you-are-eligible-to-onboard) or contact Meta's customer support.
Will be launched in Graph API v23.0.We couldn't complete ad sync for the template you attempted to send, or you might not be eligible to use the WhatsApp Marketing Messages API.Check your eligibility status. If the WhatsApp Business account's marketing_messages_lite_api_statusvalue is ONBOARDED and the issue persists,contact support.
500 Internal Server Error
1752041
(#1752041) Duplicate Request
Duplicate Request is thrown when a client has already been invited to onboard by any partner.
Onboarding requests are limited to one per business customer; only the first partner that calls the Intention API can successfully submit the request. Once a customer is onboarded, all eligible WhatsApp Business Accounts (WABA) for that customer are automatically included in the process. If you receive an error indicating an onboarding request has already been made, no further action is required because all eligible WABAs for that customer will be included without additional steps.
400 Bad Request
Last updated