Cloud API Error Codes

This topic contains the list of cloud API error codes, you can refer to them if you are using embedded signed-up

The Cloud API WhatsApp Error Codes are categorized in the following section:

Authorization Errors

CodeMessageDescriptionExpected Solution
0AuthExceptionMeta is unable to authenticate the application user.The common reason for the error is either the access token has expired, the access token has been invalidated, or the application user has changed a setting to prevent all applications from accessing their data. We recommend that you get a new access token from the application user.
3API MethodCapability or permissions issue.Use the access token debugger to verify that your application has been granted the permissions required by the endpoint.
10Permission DeniedPermission is either not granted or has been removed.Use the access token debugger to verify that your application has been granted the permissions required by the endpoint.
190Access token has expiredYour access token has expired.Get a new access token.
200-299API PermissionPermission is either not granted or has been removed.Use the access token debugger to verify that your application has been granted the permissions required by the endpoint.

Throttling Errors

CodeMessageDescriptionExpected Solution
4API Too Many CallsThe application has reached its API call rate limit.Load the application in the application Dashboard and view the Application Rate Limit section to verify that the application has reached its rate limit. In this case, try again later or reduce the frequency or amount of API queries the application makes.
80007Rate limit issuesThe WhatsApp Business Account has reached its application rate limit.See WhatsApp Business Account Rate Limits. Try again later or reduce the frequency or amount of API queries the app is making.
130429Rate limit hitCloud API message throughput has been reached.The application has reached the API's throughput limit. Try again later or reduce the frequency with which the app sends messages.
131048Spam rate limit hitMessage failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam.Check your quality status in the WhatsApp Manager.
131056(Business Account and Consumer Account) pair rate limit hitToo many messages are sent from the sender's phone number to the same recipient's phone number in a short period.Wait and retry the operation, if you intend to send messages to the same phone number. You can still send messages to a different phone number without waiting.

Integrity Errors

CodeMessageDescriptionExpected Solution
368Temporarily blocked for policies violationsThe WhatsApp Business Account associated with the application has been restricted or disabled for violating a platform policy.For more information contact the Kaleyra Support team.
131031Account has been lockedThe WhatsApp Business Account associated with the application has been restricted or disabled for violating a platform policy.

Meta is unable to verify data included in the request against the data set on the WhatsApp Business Account. For example, the two-step pin included in the request is incorrect.
For more information contact the Kaleyra Support team.

Other Errors

CodeMessageDescriptionExpected Solution
1API UnknownInvalid request or server error.In the Kaleyra.io application, check the WhatsApp Business Platform Status page to view 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.
2API ServiceTemporary due to downtime or due to being overloaded.In the Kaleyra.io application, check the WhatsApp Business Platform Status page to view API status information before trying again.
100Parameter is invalidThe request included one or more unsupported or misspelled parameters.See the endpoint's reference to determine which parameters are supported.
130472Failed to send a message because this user's phone number is part of an experiment, "href":"https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/"Message was not sent as part of an experiment.If you send a marketing template message to a customer who is part of the experiment group, your message will not be sent to the customers by Meta and you will not be billed for it, since no conversation was created. For more information contact Kaleyra Support.
131000Something went wrongThe message failed to send due to an unknown error.Try again. If the error persists, create a Direct Support ticket with Kaleyra.
131005Access deniedPermission is either not granted or has been removed.Use the access token debugger to verify that your application has been granted the permissions required by the endpoint.
131008Required parameter is missingThe request is missing a required parameter.See the endpoint's reference to determine which parameters are required.
131009Parameter value is not validOne or more parameter values are unsupported, the recipient phone number is not a valid WhatsApp phone number, or the sender phone number has not been added to the WhatsApp Business Platform.See the endpoint's reference to determine which values are supported for each parameter.

To learn how to add a phone number to a WhatsApp Business Account, see Add WhatsApp Number.
131016Service unavailableService is temporarily unavailable.To see API status information, check the WhatsApp Business Platform Status page before trying again.
131021Recipient cannot be senderThe sender's and recipient's phone number is the same.Send a message to a phone number that is different from the sender.
131026Recipient cannot receive messageThe recipient is using a version of WhatsApp that does not support the message's contents.Advise the recipient to update to the latest version of WhatsApp.
131042Business eligibility - Payment issueMessage failed to send because there were one or more errors related to your payment method.See About Billing For Your WhatsApp Business Account and verify that you have set up billing correctly.

Common problems:

1. Payment account is not attached to a WhatsApp Business Account.
2. Credit line is over the limit.
3. Credit line (Payment Account) not set or active.
4. WhatsApp Business Account is deleted.
5. WhatsApp Business Account is suspended.
6. Timezone not set.
7. Currency not set.
8. MessagingFor request (On Behalf Of) is pending or declined.
9. Exceeded conversation free tier threshold without a valid payment method.
131045Incorrect certificateThe message failed to send due to a phone number registration error.Register the phone number before trying again.
131047Re-engagement messageMore than 24 hours have passed since the recipient last replied to the sender's number.Send the recipient a business-initiated message using a message template instead.
131051Unsupported message typeUnsupported message type.See Messages for supported message types before trying again with a supported message type.
131052Media download errorThe media type sent by the WhatsApp user is not supported.See Supported Media Types. Check the details value for additional information and advise the user to resend the message using a supported format.
131053Media upload errorThe media type sent to the WhatsApp user is not supported.Check Supported Media Types. Also, check the details value for additional information and try again using a media format that is supported.
132000Template Param Count MismatchThe 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.
132001Template 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.
132005Template Hydrated Text Too Long The translated text is too long.Check the WhatsApp Manager to verify that your template has been translated.
132007Template Format Character Policy ViolatedTemplate content violates a WhatsApp policy.See Rejection Reasons to determine possible reasons for violation.
132012Template Parameter Format MismatchVariable parameter values are formatted incorrectly.The variable parameter values included in the request are not using the format specified in the template.
132015Template parameter invalidTemplate parameters are invalid or missing. Make sure you follow message template guidelines. Verify the following:

you are providing the right parameter count
the template exists and is approved
the template’s name and language locale are correct
the template has been translated correctly.
133000Incomplete DeregistrationA previous deregistration attempt failed.Deregister the number again before registering.
133004Server Temporarily UnavailableThe server is temporarily unavailable.Check the WhatsApp Business Platform Status page to see API status information and check the response details value before trying again.
133005Two step verification PIN MismatchTwo-step verification PIN incorrect.Verify that the two-step verification PIN included in the request is correct.

To reset the two-step verification PIN:

Disable two-step authorization.
Send a POST request that includes the new PIN to the Phone Number endpoint.
133006Phone number re-verification neededThe phone number needs to be verified before registering.Verify the phone number before registering it.
133008Too Many two step verification PIN GuessesToo many two-step verification PIN guesses for this phone number.Try again after the amount of time specified in the detailed response value.
133009Two step verification PIN Guessed Too FastTwo-step verification PIN was entered too quickly.Check the detailed response value before trying again.
133010Phone number Not RegisteredPhone number is not registered on the Whatsapp Business Platform.Register the phone number before trying again.
135000Generic user errorThe message failed to send because of an unknown error with your request parameters.See the endpoint's reference to determine if you are querying the endpoint using the correct syntax. Contact customer support if you continue receiving this error code in response.