WhatsApp Business API Errors

BizMagnets is committed to enhancing your communication experience. We provide clear explanations and solutions for common error codes to ensure smooth and uninterrupted communication.

BizMagnets aims to streamline your communication process. "If you encounter any errors, it's essential to understand and resolve them quickly to maintain uninterrupted communication. Here are straightforward explanations and solutions for frequently encountered error codes:

Error Codes	Description	Solution
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.
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.
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.
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. 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 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 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 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' 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 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. rephrase
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.
131008 Required parameter is missing	The request is missing a required parameter.	Check the endpoint's 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 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.
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'.
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 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 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 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 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.
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.