Error Code Reference

This page contains all WhatsApp API error codes and steps to potentially resolve them.

360dialog Messaging Errors

Code	Description / Developer message	Possible Solution
400	Your WhatsApp for Business API has been disabled	Contact support.
400	You have exceeded the endpoint rate limit.	Implement request throttling or exponential backoff to cool down API requests and avoid exceeding rate limits. Contact support.
400	Could not send message due to lack of payment. Messaging can resume once overdue invoices towards 360dialog are settled. Please reach out to our integration partner.	Contact integration partner or support to resolve account billing issues.
401	Invalid api_key	Check that the API is the correct and valid for the number you are trying to use. Generate another API key if requried. Check the key value is being passed in the header: D360-API-KEY
403	The endpoint is blocked	Contact support to see if the specific endpoint can be enabled.
500	Internal server error	There are various reasons for this error. Contact support.
502	WhatsApp for Business API not available	Contact support.

360dialog Partner API Errors

Code	Description / Developer message	Possible Solution
403	Permission denied for partner x	Verify the Auth token header is valid Confirm the user has the necessary permissions to access this Partner Hub. If the issue persists, contact 360dialog support

Meta Cloud API Integrity Errors

Meta Error Code	Description	Possible Solutions	HTTP Status Code
368 - Temporarily blocked for policies violations	The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy.	See the Policy Enforcement document to learn about policy violations and how to resolve them. Contact support.	403 - Forbidden
130497 - Business account is restricted from messaging users in this country.	The WhatsApp Business Account is restricted from messaging to users in certain countries.	See WhatsApp Business Messaging Policy for details on allowed countries for messaging in your business category.	403 - Forbidden
131031 - Account has been locked	The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy, or we were unable to verify data included in the request against data set on the WhatsApp Business Account (e.g, the two-step pin included in the request is incorrect).	See the Policy Enforcement document to learn about policy violations and how to resolve them. You can also use the Health Status API, which may provide additional insight into the reason or reasons for the account lock.	403 - Forbidden

Other Meta Cloud API Errors

Meta Error Code	Description	Possible Solutions	HTTP Status Code
1 - API Unknown	Invalid request or possible server error.	Check the WhatsApp Business Platform Status page to see API status information. If there are no server outages, check the endpoint reference and verify that your request is formatted correctly and meets all endpoint requirements.	400 Bad Request
2- API Service	Temporary due to downtime or due to being overloaded.	Check the WhatsApp Business Platform Status page to see API status information before trying again.	503 - Service Unavailable
130472 - User's number is part of an experiment	Message was not sent as part of an experiment.	See Marketing Message Experiment.	400 - Bad Request
131000 - Something went wrong	Message failed to send due to an unknown error.	Try again. If the error persists, contact 360dialog support.	500 - Internal Server Error
131005 - Access denied	Permission is either not granted or has been removed.	Try again. If the error persists, contact 360dialog support.	403 - Forbidden
131008 - Required parameter is missing	The request is missing a required parameter.	See the endpoint's reference to determine which parameters are required.	400 - Bad Request
131016 - Service unavailable	A service is temporarily unavailable.	Check the WhatsApp Business Platform Status page to see API status information before trying again. If the error persists, contact 360dialog support.	500 - Internal Server Error
131021	Sender and recipient phone number is the same.	Send a message to a phone number different from the sender.	400 - Bad Request
131026 - Message Undeliverable	Unable to deliver message. The following scenarios can cause a message to appear as sent but not delivered. For many of these reasons, Meta does not disclose the underlying cause of the error, due to privacy and policy reasons. The recipient phone number is not a WhatsApp phone number. The customer has blocked the business. The customer is in a restricted or sanctioned country. Recipient has not accepted Meta's new Terms of Service and Privacy Policy. Recipient using an old WhatsApp version; must use the following WhatsApp version or greater: 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	Using a non-WhatsApp communication method, ask the WhatsApp user to: Confirm that they can actually send a message to your WhatsApp business phone number Confirm that your WhatsApp business phone number is not in their list of blocked numbers (Settings > Privacy > Blocked or Blocked contacts) Confirm that they have accepted Meta latest Terms of Service (Settings > Help, or Settings > Application information will prompt them to accept the latest terms/policies if they haven't done so already) Update to the latest version of the WhatsApp client	400 - Bad Request
131037 - WhatsApp provided number needs display name approval before message can be sent.	The 555 business phone number used to send the request does not have an approved display name.	Change the 555 business phone number's display name. See our How to change your WhatsApp Business display name Help Center article to learn how.	400 - Bad Request
131042 - Business eligibility payment issue	There was an error related to your payment method.	Common problems: Payment account is not attached to a WhatsApp Business Account Credit line is over the limit Credit line (Payment Account) not set or active WhatsApp Business Account is deleted WhatsApp Business Account is suspended Timezone not set Currency not set MessagingFor request (On Behalf Of) is pending or declined Exceeded conversation free tier threshold without a valid payment method	400 - Bad Request
131047 - Re-engagement message	More than 24 hours have passed since the recipient last replied to the sender number.	Send the recipient a business-initiated message using a message template instead.	400 - Bad Request
131049 - Meta chose not to deliver.	This message was not delivered to maintain healthy ecosystem engagement.	Do not retry immediately if you do receive this error code and suspect it is due to the limit. Instead, retry in increasing larger time increments until the message is delivered, since the limit may be in effect for differing periods of time. See Per-User Marketing Template Message Limits for additional information.	400 - Bad Request
131051 - Unsupported message type	Unsupported message type.	See Messages for supported message types before trying again with a supported message type.	400 - Bad Request
131052 - Media download error	Unable to download the media sent by the user.	We were unable to download media included in the WhatsApp user's message. For more information, refer to the error.error_data.details value in any messages webhooks triggered when this message was received. Ask the WhatsApp user to send you the media file using a non-WhatsApp method.	400 - Bad Request
131053 - Media upload error	Unable to upload the media used in the message.	We were unable to upload the media for one or more reasons, such as an unsupported media type. For more information, refer to the error.error_data.details value in any messages webhooks triggered when this message fails to send. We recommend that you inspect any media files that are causing errors and confirm that they are in fact supported. For example, in UNIX you can use file inspection via the command line to determine its MIME type: file -I rejected-file.mov You can then confirm if its MIME type is supported. See Supported Media Types.	400 - Bad Request
131057 - Account in maintenance mode	Buiness Account is in maintenance mode	The WhatsApp Business Account is in maintenance mode. One reason for this could be that the account is undergoing a throughput upgrade.	500 - Bad Request
132000 - Template Param Count Mismatch	The number of variable parameter values included in the request did not match the number of variable parameters defined in the template.	See Message Template Guidelines and make sure the request includes all of the variable parameter values that have been defined in the template.	400 - Bad Request
132001 - Template does not exist	The template does not exist in the specified language or the template has not been approved.	Make sure your template has been approved and the template name and language locale are correct. Please ensure you follow message template guidelines.	404 - Not Found
132005 - Template Hydrated Text Too Long	Translated text is too long.	Check the WhatsApp Manager to verify that your template has been translated. See Quality Rating and Template Status.	400 - Bad Request
132007 - Template Format Character Policy Violated	Template content violates a WhatsApp policy.	See Rejection Reasons to determine possible reasons for violation.	400 - Bad Request
132012 - Template Parameter Format Mismatch	Variable parameter values formatted incorrectly.	The variable parameter values included in the request are not using the format specified in the template. See Message Template Guidelines.	400 - Bad Request
135000 - Generic user error	Message failed to send because of an unknown error with your request parameters.	The error you encountered was related to template restrictions, which are in place due to Meta security concerns. Unfortunately, Meta will disclose further details about these restrictions. Contact 360dialog support	400 - Bad Request

Meta Number Registration Errors

Code	Description	Possible Solution	HTTP Status Code
1005 - Timeout	Registration timeout	Wait until the timeout phase has lapsed and try again.	403 - Forbidden
1005 - Unknown error: biz_link_info_invalid_payload	The WhatsApp App or WhatsApp Business App account was not deleted.	Reinstall WhatsApp or WhatsApp Business and then fully delete it. This will allow the number to be registered for the WhatsApp Business API.	403 - Forbidden
1005 - This number has not been approved for an enterprise	The WhatsApp App or WhatsApp Business App account was not deleted.	Reinstall WhatsApp or WhatsApp Business and then fully delete it. This will allow the number to be registered for the WhatsApp Business API.	403 - Forbidden
1005 - There was an error verifying this phone number	This means that the registration has been locked.	Contact 360dialog support.	403 - Forbidden