| Code |
Details |
Possible Causes and Solutions |
HTTP Status Code |
| 1 |
Unknown API |
The request is invalid, or a server error may have occurred. Please check the API status information. If the server is not down, confirm that the request format is correct and meets all endpoint requirements. |
400 Bad Request |
| 2 |
API Service |
A temporary issue has occurred due to downtime or overload. Please check the API status information and try again. |
503 Service Unavailable |
| 33 |
Invalid parameter value |
The business phone number has been deleted. Please confirm that the business phone number is correct. |
400 Bad Request |
| 100 |
Invalid parameter |
The request contains one or more unsupported or misspelled parameters. |
400 Bad Request |
| 130472 |
User's number is involved in an experiment |
The message was not sent because the recipient's number is part of an experiment. |
400 Bad Request |
| 131000 |
Unknown error |
If the request still fails after retrying, please contact technical support to submit a ticket to Meta. |
500 Internal Server Error |
| 131005 |
Access denied |
Permission was not granted or has been removed. Please confirm the app permissions. |
403 Forbidden |
| 131008 |
Required parameter missing |
A required parameter is missing from the request. |
400 Bad Request |
| 131009 |
Invalid parameter value |
One or more parameter values are invalid. |
400 Bad Request |
| 131016 |
Service unavailable |
The service is temporarily unavailable. Please check the API status information and try again. |
500 Internal Server Error |
| 131021 |
Recipient cannot be the sender |
The sender and recipient numbers are the same. Please send the message to a different number. |
400 Bad Request |
| 131026 |
Message undeliverable |
Possible reasons include: the recipient is not a WhatsApp user, has not accepted the new Terms of Service, is using an outdated version of WhatsApp, is not a WhatsApp contact, or has not updated the client. Please ask the user to confirm that they can send messages to your business number, accept the terms, and update the client. |
400 Bad Request |
| 131037 |
Phone number display name not approved |
The business number used to send the request does not have an approved display name. Please change the display name. |
400 Bad Request |
| 131042 |
Business payment eligibility issue |
The payment method is configured incorrectly. Please confirm that billing settings, limits, payment account, time zone, and currency are correct. |
400 Bad Request |
| 131045 |
Incorrect certificate |
Message sending failed due to an incorrect number registration. Please re-register the number and try again. |
500 Internal Server Error |
| 131047 |
Re-engagement message |
More than 24 hours have passed since the recipient last replied. Please send a template message instead. |
400 Bad Request |
| 131049 |
Meta chose not to deliver |
The message was not delivered to maintain ecosystem health. Please wait at least 24 hours before resending the template message. |
400 Bad Request |
| 131050 |
User has stopped receiving marketing messages |
The recipient has opted out of receiving marketing messages. Please do not try again. |
400 Bad Request |
| 131051 |
Unsupported message type |
The message type is not supported. Please refer to the message type documentation and use a supported type. |
400 Bad Request |
| 131052 |
Error downloading media content |
Unable to download the media content sent by the user. |
400 Bad Request |
| 131053 |
Error uploading media content |
Unable to upload the media content in the message. Please confirm that the file type is supported. |
400 Bad Request |
| 131057 |
Account in maintenance mode |
The business account is in maintenance mode, possibly due to reasons such as throughput upgrades. |
500 Bad Request |
| 132000 |
Template parameter count mismatch |
The number of variable parameters does not match the template definition. |
400 Bad Request |
| 132001 |
Template does not exist |
The template does not exist in the specified language or has not been approved. Please make sure the template is approved and that the name and language settings are accurate. |
404 Not Found |
| 132005 |
Template text too long |
The translated text is too long. Please confirm that the template has been translated and refer to the template quality documentation. |
400 Bad Request |
| 132007 |
Violates template format character policy |
The template content violates WhatsApp policy. Please refer to the template review documentation. |
400 Bad Request |
| 132012 |
Template parameter format mismatch |
The format of the variable parameter values is incorrect. |
400 Bad Request |
| 132015 |
Template suspended |
The template has been suspended due to low quality and cannot be sent. Please edit the template to improve quality and try again after approval. |
400 Bad Request |
| 132016 |
Template disabled |
The template has been suspended multiple times due to low quality and is now permanently disabled. Please create a new template with different content. |
400 Bad Request |
| 132068 |
Flows blocked |
Flows are in a blocked state. Please correct the Flows. |
400 Bad Request |
| 132069 |
Flows throttled |
Flows are in a throttled state, and 10 messages have already been sent within 1 hour. Please correct the Flows. |
400 Bad Request |
| 133000 |
Deregistration incomplete |
The previous deregistration attempt failed. Please deregister the number again before registering it. |
500 Internal Server Error |
| 133004 |
Server temporarily unavailable |
The server is temporarily unavailable. Please check the API status information, review the details value in the response, and then try again. |
503 Service Unavailable |
| 133005 |
Two-step verification PIN mismatch |
The two-step verification PIN is incorrect. Please confirm the PIN, or disable two-step verification and set a new PIN. |
400 Bad Request |
| 133006 |
Phone number needs to be re-verified |
The phone number must be verified before it can be registered. Please verify it first and then register it. |
400 Bad Request |
| 133008 |
Too many two-step verification PIN attempts |
Too many PIN attempts have been made. Please try again after the time specified in details. |
400 Bad Request |
| 133009 |
Two-step verification PIN entered too quickly |
The PIN was entered too quickly. Please check details and try again. |
400 Bad Request |
| 133010 |
Phone number not registered |
The number is not registered. Please register it and try again. |
400 Bad Request |
| 133015 |
Please wait a few minutes before registering again |
The current number was recently deleted, and the deletion has not yet been completed. Please wait 5 minutes and try again. |
400 Bad Request |
| 134011 |
Payment terms of service not accepted |
The account is waiting for acceptance of the WhatsApp payment Terms of Service. Please use the link in the error message to accept the terms and try again. |
400 Bad Request |
| 135000 |
General user error |
An unknown error occurred in the request parameters. Please confirm the endpoint syntax. If the issue persists, contact customer support. |
400 Bad Request |
