0
AuthException
| We were unable to authenticate the app user. | This usually indicates that the included access token has expired, been invalidated, or the app user has changed settings to block all apps from accessing their data. We suggest obtaining a [new access token](https://developers.facebook.com/docs/whatsapp/business-management-api/get-started#system-user-access-tokens). | |3
API Method
| Capability or Permissions Issue | Use the access token debugger to verify that your app has the necessary permissions for the endpoint. For more details, refer [Troubleshooting](https://developers.facebook.com/docs/whatsapp/cloud-api/support#authentication-authorization). | |10
Permission Denied
| Permission has either not been granted or has been revoked. | Use the access token debugger to confirm that your app has the necessary permissions for the endpoint. Refer [Troubleshooting](https://developers.facebook.com/docs/whatsapp/cloud-api/support#authentication-authorization). | |190
Access token has expired
| Your access token has expired. | Ensure that the phone number used to set the business public key is allow listed. | |200-299
API Permission
| Permission has either not been granted or has been revoked. | Please obtain a new access token. | |4
API Too Many Calls
| The app has hit its API call rate limit. | Check the Application Rate Limit section in the App Dashboard to confirm if the app has reached its limit. If so, try again later or reduce the frequency or number of API calls being made by the app. | |80007
Rate limit issues
| The WhatsApp Business Account has reached its rate limit. | Refer to the WhatsApp Business Account [Rate Limits](https://developers.facebook.com/docs/whatsapp/cloud-api/overview/#rate-limits). Try again later or reduce the frequency or number of API queries being made. | |130429
Rate limit hit
| Cloud API message throughput has been reached. | The app has exceeded the API's throughput limit. Try again later or reduce the frequency at which the app sends messages. | |131048
Spam rate limit hit
| The message failed to send due to restrictions on the number of messages allowed from this phone number. This could be a result of multiple previous messages being blocked or marked as spam. | To resolve this, check your quality status in the WhatsApp Manager and refer to the [Quality-Based Rate Limits](https://docs.bizmagnets.ai/whatsapp-channel/messaging-limits-and-quality-ratings) documentation for further details. | |131056
(Business Account, Consumer Account) pair rate limit hit
| Too many messages have been sent from the sender phone number to the same recipient in a short period. | Wait and try the operation again if you intend to send messages to the same phone number. You can still send messages to a different phone number without waiting. | |133016
Account register deregister rate limit exceeded
| Registration or deregistration failed due to too many attempts for this phone number in a short period. | The business phone number is blocked because it has reached the limit for registration/deregistration attempts. Try again once the number is unblocked. Refer to the "Limitations" section in the Registration document for more details. | |368
Temporarily blocked for policies violations
| The WhatsApp Business Account linked to the app has been restricted or disabled due to a platform policy violation. | Refer to the[ Policy Enforcement ](https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement/)document to understand the violations and how to resolve them. | |130497
Business account is restricted from messaging users in this country.
| The WhatsApp Business Account is restricted from messaging users in certain countries. | Check the [WhatsApp Business Messaging Policy ](https://business.whatsapp.com/policy)for information on the countries where messaging is allowed for your business category. | |131031
Account has been locked
| Problems with the WhatsApp Business Account connected to the app. | Refer to the[ 'Policy Enforcement document'](https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement/) for instructions on how to address violations or errors. | |1
API Unknown
| Invalid request or potential server error. | Check the WhatsApp Business Platform Status page for API status updates. If there are no server outages, verify the endpoint reference to ensure your request is correctly formatted and meets all the endpoint requirements. | |2
API Service
| Temporary issue due to downtime or overload. | Visit the WhatsApp Business Platform Status page to check the API status before retrying. | |33
Parameter value is not valid
| The business phone number has been deleted. | Ensure that the business phone number is correct. | |100
Invalid parameter
| The request included one or more unsupported or incorrectly spelled parameters. |Refer to the endpoint's reference to confirm which parameters are supported and their correct spelling.
When setting the business public key, ensure it is a valid 2048-bit RSA public key in PEM format.
Verify there is no mismatch between the phone number ID you're registering and any previously stored phone number ID.
Make sure your parameter adheres to any length restrictions for its type.
| |130472
User's number is part of an experiment
| The message was not sent as part of an experiment. | Refer to the Marketing Message [Experiment](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/experiments) for more details. | |131000
Something went wrong
| The message did not send because of an unknown error. | Message failed due to an unknown error. Wait for 10 minutes. If the issue persists, raise a support ticket. | |131005
Access denied
| Permission has either not been granted or has been revoked. | Use the access token debugger to confirm that your app has the necessary permissions for the endpoint. Refer [Troubleshooting](https://developers.facebook.com/docs/whatsapp/cloud-api/support#authentication-authorization). | |131008
Required parameter is missing
| The request is missing a required parameter. | Check the endpoint's [reference](https://developers.facebook.com/docs/whatsapp/cloud-api/reference) to identify which parameters are required. | |131009
Parameter value is not valid
| One or more parameter values are invalid. | Refer to the endpoint's [reference](https://developers.facebook.com/docs/whatsapp/cloud-api/reference) to identify the supported values for each parameter, and visit the Phone Numbers section to learn how to add a phone number to a WhatsApp Business Account. | |131016
Service unavailable
| A service is temporarily unavailable. | Visit the WhatsApp Business Platform Status page to check the API status before trying again. | |131021
Recipient cannot be sender
| The sender and recipient phone numbers are the same. | Send the message to a different phone number from the sender. | |131026
Message Undeliverable
| Messages may fail to deliver for various reasons, such as the recipient not having WhatsApp, not consenting to updated policies, or using an outdated version of the app. | Ensure the recipient meets the WhatsApp version requirements and has agreed to the latest rules. If necessary, propose alternative communication methods. [Read more](https://docs.bizmagnets.ai/additional-details/new-per-user-messaging-limits-on-whatsapp). | |131037
WhatsApp provided number needs display name approval before message can be sent.
| The 555 business phone number used for the request does not have an approved display name. | Update the display name for the 555 business phone number. Refer ['How to change your display name'](https://docs.bizmagnets.ai/whatsapp-channel/how-to-change-your-display-name). | |131042
Business eligibility payment issue
| Problems with the payment method for WhatsApp Business. |Ensure all previous dues associated with your account have been settled.
If there are no outstanding balances and the issue remains, please contact the Support team for additional help.
| |131045
Incorrect certificate
| The message failed to send due to a phone number registration error. | Please register the phone number before attempting to send the message again. | |131047
Re-engagement message
| The message did not send because there was no reply from the customer within 24 hours. To continue the conversation, use a message template. | Start a conversation using a template or encourage the user to initiate a message. | |131049
Meta chose not to deliver.
| This message was not delivered to help maintain a healthy engagement ecosystem. |Avoid retrying immediately if you encounter this error code and believe it's due to reaching a limit. Instead, try resending the message after gradually increasing time intervals, as the limit may apply for varying durations.
For more details, refer to "New Per-user messaging Limits"
| |131051
Unsupported message type
| The message type is not supported. | Please refer to the list of supported message types in the [Messages](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages) section before retrying with a valid message type. | |131052
Media download error
| Media files larger than 100MB sent by the user cannot be downloaded. | For reliable sending, compress the media to less than 10MB. | |131053
Media upload error
| Supported media types are subject to size restrictions. Files larger than 100MB will trigger a 'File too big' notification. | To ensure reliable transmission, compress media files to less than 10MB. | |131057
Account in maintenance mode
| Business Account is in Maintenance Mode. | The WhatsApp Business Account is currently in maintenance mode. This may be due to the account undergoing a throughput upgrade. | |132000
Template Param Count Mismatch
| The number of variable parameter values in the request does not match the number of variable parameters defined in the template. | Refer to the [Template Message](https://docs.bizmagnets.ai/template) Guidelines to ensure the request includes all the variable parameter values defined in the template. | |132001
Template does not exist
| The template does not exist in the specified language, or it has not been approved. | Ensure your template has been approved and that the template name and language locale are correct. Follow the [message template](https://docs.bizmagnets.ai/template) guidelines to avoid issues. | |132005
Template Hydrated Text Too Long
| The translated text is too long. | Check the WhatsApp Manager to confirm your template has been properly translated. Refer to the Quality Rating and Template Status for more information. | |132007
Template Format Character Policy Violated
| The template content violates a WhatsApp policy. | Consult the Rejection Reasons to understand the possible cause of the violation. | |132012
Template Parameter Format Mismatch
| Variable parameter values are incorrectly formatted. | The variable parameter values in the request do not match the format specified in the template. Refer to the [Message Template](https://docs.bizmagnets.ai/template) Guidelines for proper formatting. | |132015
Template is Paused
| The template is paused due to low quality and cannot be sent in a template message. | Edit the template to improve its quality and try again once it is approved. | |132016
Template is Disabled
| The template has been paused multiple times due to low quality and is now permanently disabled. | Create a new template with different content. | |132068
Flow is blocked
| The flow is in a blocked state. | Resolve the issue with the flow. | |132069
Flow is throttled
| The flow is in a throttled state, and 10 messages using this flow have already been sent in the last hour. | Fix the flow to resolve the issue. | |133000
Incomplete Deregistration
Incomplete Deregistration
| A previous deregistration attempt failed. | Deregister the number again before attempting to register. | |133004
Server Temporarily Unavailable
| The server is temporarily unavailable. | Check the WhatsApp Business Platform Status page for API status updates and review the response details before trying again. | |133005
Two step verification PIN Mismatch
| The two-step verification PIN is incorrect. | Ensure that the two-step verification PIN included in the request is correct. | |133006
Phone number re-verification needed
| The phone number needs to be verified before registering. | Verify the phone number before attempting to register it. | |133008
Too Many two step verification PIN Guesses
| Too many incorrect two-step verification PIN attempts for this phone number. | Wait until the specified time in the details response value before trying again. | |133009
Two step verification PIN Guessed Too Fast
| The two-step verification PIN was entered too quickly. | Refer to the details response value and wait before trying again. | |133010
Phone number Not Registered
| The phone number is not registered on the WhatsApp Business Platform. | Register the phone number before attempting to proceed. | |133015
Please wait a few minutes before attempting to register this phone number
| The phone number you are attempting to register was recently deleted, and the deletion process is not yet complete. | Wait 5 minutes before trying the request again. | |130472
User's number is part of an experiment
| Marketing template message was not delivered to a customer as they are part of an experiment group that restricts such messages. | To reach the customer, contact them through another non-WhatsApp channel and request that they message you on WhatsApp. This will allow you to resend the message within the customer service window. | |135000
Generic user error
| Message failed to send due to an unknown error with your request parameters. | Check the endpoint's reference to ensure you're using the correct syntax. Contact customer support if the error persists. | | **`472`** | WhatsApp testing may impact the delivery of marketing messages, preventing users from receiving them unless there is an ongoing conversation. | Reach out to users via alternative channels and encourage them to start a message on WhatsApp during the permissible window. | | **`1014`** | Problems with uploading images or files online are commonly due to technical issues or content integrity checks. | To mitigate these problems, convert images to `JPG` format, videos to `MP4`, and documents to `PDF`. Additionally, verify the integrity of the content before uploading. | | **`1026`** | Messages may fail to deliver for a variety of reasons. | Verify that the recipient uses WhatsApp and that their app is updated to the required version. If necessary, recommend alternative communication methods. | | **`1000`** | The message failed to send because of server problems. | Please wait for 10 minutes before trying again. If the problem continues, submit a support ticket. | | **`470`** | The message failed because there was no reply from the customer within 24 hours. To restart the conversation, use a message template. | Begin a new conversation with a template or encourage the user to initiate a message. | | **`1011`** | Service is experiencing downtime or is overloaded. Please try again in 15 minutes. | Attempt to resend the message after a 15-minute wait. | | **`408`** | If a message has been pending for an extended time, resend after 15 minutes. | Try resending it after waiting 15 minutes. | | **`471`** | Your phone number has messaging limits due to previous blocks or being marked as spam. | Verify your 'quality status' in WhatsApp Manager and consult the 'Quality-Based Rate Limits' [documentation](https://docs.bizmagnets.ai/messaging-limits-and-quality-ratings#messaging-limits). | | **`1023`** | Database issue. | Please wait 10 minutes and if the problem continues, submit a support ticket. | | **`1006`** | File or item not found. | Ensure the correct media format has been uploaded. | | **`2028`** | This is only accessible to businesses in India due to incomplete e-commerce compliance details. | Please update your Compliance Information on BizMagnets within WhatsApp Manager. | | **`2027`** | The shared catalog contains no products. | Check the catalogs linked in BizMagnets. If the problem continues, submit a support ticket. |