Authorization Errors
| Code | Reason / Meaning |
|---|---|
| 0 | We were unable to authenticate the app user. The access token is expired, invalid, or the app user has changed their settings. |
| 3 | Feature or permission issue. |
| 10 | Permission not granted or has been removed. |
| 190 | Your access token has expired. |
| 200 | No access token provided. The API returns “Provide valid app ID”. |
| 200-299 | Permission not granted or has been removed. |
Integrity Errors
| Code | Reason / Meaning |
|---|---|
| 368 | The WhatsApp Business Account has been restricted or disabled for violating a platform policy. |
| 130497 | The WhatsApp Business Account is restricted from messaging to users in certain countries. |
| 131031 | The WhatsApp Business Account has been restricted/disabled for policy violation, or verification failed (e.g., incorrect two-step PIN). |
Template Creation Errors
| Code | Reason / Meaning |
|---|---|
| 2388039 | Message template status cannot be changed. You can only delete or add templates (e.g., templates still in review). |
| 2388040 | Character limit exceeded. A field in the template exceeds the maximum character limit. |
| 2388047 | Message header format is invalid. |
| 2388072 | Message body format is invalid. |
| 2388073 | Message footer format is invalid. |
| 2388293 | Parameter-to-text ratio exceeded. Too many variables for the message length. |
| 2388299 | Cannot start or end with a parameter. Variables cannot be placed at the beginning or end of a template. |
Send Template Errors
| Code | Reason / Meaning |
|---|---|
| 2388019 | You have exceeded the maximum number of message templates (250) for this WhatsApp Business Account. |
Phone Number Migration Errors
| Code | Reason / Meaning |
|---|---|
| 2388012 | This phone number already exists in your WhatsApp account. |
| 2388091 | This phone number is not in the migration flow and is not eligible to receive verification codes. |
| 2388093 | This phone number is not in the migration flow and is not eligible to receive verification codes. |
| 2388103 | Generic migration failure with various details: - Target WABA has no webhook set. - Number is eligible for direct addition. - Display name is not approved. - Source WABA is not set up correctly. - No payment account on the WABA. - Number belongs to a different Business Manager account. - Target WABA is not approved. - “代发消息” request not approved. - Error during migration. |
| 2494100 | Account is in maintenance mode. Retry in a few minutes. |
Template Insights Errors
| Code | Reason / Meaning |
|---|---|
| 200005 | Template insights are not available for this WhatsApp Business Account. |
| 200006 | Cannot disable template insights. Once enabled, they cannot be disabled. |
| 200007 | Template insights have not been enabled for this WhatsApp Business Account. |
Waba Errors
| Code | Reason / Meaning |
|---|---|
| 2593079 | This WABA has been flagged for migration to another solution number. OBO account ownership mode is deprecated. |
| 2593085 | Invalid WhatsApp Business Account for OBO Mobility. WABA is not eligible for OBO ownership transfer. |
Synchronization Errors
| Code | Reason / Meaning |
|---|---|
| 2593107 | You have exceeded the maximum number of times to call the synchronization API for this phone number. |
| 2593108 | Synchronization request can only be made within 24 hours of registration. |
Throttling Errors
| Code | Reason / Meaning |
|---|---|
| 4 | This app has reached its API call rate limit. |
| 80007 | The WhatsApp Business Account has reached its rate limit. |
| 130429 | Cloud API message throughput has been reached. |
| 131048 | This phone number has been restricted from sending messages due to quality issues or spam flags. |
| 131056 | Too many messages sent from the sender to the same recipient in a short period. |
| 131064 | Account has reached its message limit due to template category violations. |
| 133016 | Registration/Deregistration failed due to too many attempts for this phone number in a short period. |
Other Errors
| Code | Reason / Meaning |
|---|---|
| 1 | Invalid request or possible server error. |
| 2 | Temporary issue due to downtime or overload. |
| 33 | Business phone number has been deleted. |
| 100 | One or more parameters are unsupported or misspelled. |
| 130403 | Message undeliverable. The business has blocked this WhatsApp user. |
| 130472 | Message was not sent as part of an experiment. |
| 131000 | Unknown error occurred, message sending failed. Retry. |
| 131005 | Permission not granted or has been removed. |
| 131008 | Required parameter missing in the request. |
| 131009 | One or more parameter values are invalid. |
| 131016 | Service temporarily unavailable. |
| 131021 | Sender and recipient phone numbers are the same. |
| 131026 | Message undeliverable. Reasons: - Recipient is not a WhatsApp number. - Recipient hasn’t accepted new terms/privacy policy. - Recipient is using an outdated WhatsApp version. |
| 131037 | The 555 business phone number does not have an approved display name. |
| 131042 | Payment method error. Billing is not set up correctly. |
| 131045 | Message sending failed due to phone number registration error. |
| 131047 | More than 24 hours have passed since the recipient’s last reply. Send a template message instead. |
| 131049 | Message not delivered to maintain healthy ecosystem engagement. Wait 24 hours. |
| 131050 | Message undeliverable. Recipient has opted out of marketing messages. |
| 131051 | Unsupported message type. |
| 131052 | Cannot download user’s media. |
| 131053 | Cannot upload media used in the message. |
| 131057 | Business account is in maintenance mode. |
| 131063 | Your template is classified as “marketing” but marketing templates are currently disabled on your Cloud API configuration. |
| 132000 | Number of variable parameter values does not match the template definition. |
| 132001 | Template does not exist in the specified language or has not been approved. |
| 132005 | Translation text is too long. |
| 132007 | Template content violates WhatsApp policy. |
| 132012 | Variable parameter value format is incorrect. |
| 132015 | Template suspended due to low quality. Edit and resubmit. |
| 132016 | Template permanently disabled due to repeated low quality. |
| 132068 | Flows is in a blocked state. |
| 132069 | Flows is throttled. 10 messages using this Flows have been sent in the past hour. |
| 133000 | Previous deregistration attempt failed. |
| 133004 | Server temporarily unavailable. |
| 133005 | Two-step verification PIN is incorrect. |
| 133006 | Phone number needs to be verified before registration. |
| 133008 | Too many two-step verification PIN attempts. Retry after the specified time. |
| 133009 | Two-step verification PIN entered too quickly. |
| 133010 | Phone number is not registered on WhatsApp Business Platform. |
| 133015 | The phone number you are trying to register was recently deleted and the deletion is not complete. Wait 5 minutes. |
| 134011 | Message failed to send because WhatsApp Payments terms of service acceptance is pending for this WhatsApp Business Account. |
| 135000 | Unknown error with your request parameters. Message sending failed. |
Marketing Message API Errors
| Code | Reason / Meaning | HTTP Status |
|---|---|---|
| 100 | Invalid parameter. Message must be a template message. | 400 |
| 131009 | Parameter value is not valid. | 400 |
| 131055 | Method not allowed. Only marketing template messages are supported. | 400 |
| 134100 | Only marketing messages supported. You’re trying to send a transactional or authentication template. | 400 |
| 134101 | Your template is still syncing. Wait up to 10 minutes. | 400 |
| 134102 | Template unavailable for use. Check eligibility status or contact support. | 500 |
| 132018 | Template validation error. Issue with parameters in your template. | 400 |
| 1752041 | Duplicate Request. Client has already been invited to onboard by another partner. | 400 |