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

Code

Message

Description

Expected Solution

368

Temporarily blocked for policies violations

The 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.

131031

Account has been locked

The 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

Code

Message

Description

Expected Solution

1

API Unknown

Invalid 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.

2

API Service

Temporary 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.

100

Parameter is invalid

The request included one or more unsupported or misspelled parameters.

See the endpoint's reference to determine which parameters are supported.

130472

Failed 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.

131000

Something went wrong

The message failed to send due to an unknown error.

Try again. If the error persists, create a Direct Support ticket with Kaleyra.

131005

Access denied

Permission 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.

131008

Required parameter is missing

The request is missing a required parameter.

See the endpoint's reference to determine which parameters are required.

131009

Parameter value is not valid

One 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.

131016

Service unavailable

Service is temporarily unavailable.

To see API status information, check the WhatsApp Business Platform Status page before trying again.

131021

Recipient cannot be sender

The sender's and recipient's phone number is the same.

Send a message to a phone number that is different from the sender.

131026

Recipient cannot receive message

The 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.

131042

Business eligibility - Payment issue

Message 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.

131045

Incorrect certificate

The message failed to send due to a phone number registration error.

Register the phone number before trying again.

131047

Re-engagement message

More 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.

131051

Unsupported message type

Unsupported message type.

See Messages for supported message types before trying again with a supported message type.

131052

Media download error

The 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.

131053

Media upload error

The 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.

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.

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.

132005

Template Hydrated Text Too Long

The translated text is too long.

Check the WhatsApp Manager to verify that your template has been translated.

132007

Template Format Character Policy Violated

Template content violates a WhatsApp policy.

See Rejection Reasons to determine possible reasons for violation.

132012

Template Parameter Format Mismatch

Variable parameter values are formatted incorrectly.

The variable parameter values included in the request are not using the format specified in the template.

132015

Template parameter invalid

Template 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.

133000

Incomplete Deregistration

A previous deregistration attempt failed.

Deregister the number again before registering.

133004

Server Temporarily Unavailable

The 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.

133005

Two step verification PIN Mismatch

Two-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.

133006

Phone number re-verification needed

The phone number needs to be verified before registering.

Verify the phone number before registering it.

133008

Too Many two step verification PIN Guesses

Too many two-step verification PIN guesses for this phone number.

Try again after the amount of time specified in the detailed response value.

133009

Two step verification PIN Guessed Too Fast

Two-step verification PIN was entered too quickly.

Check the detailed response value before trying again.

133010

Phone number Not Registered

Phone number is not registered on the Whatsapp Business Platform.

Register the phone number before trying again.

135000

Generic user error

The 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.





© 2025 Kaleyra Inc. All rights reserved.
Trademarks, logos and service marks displayed on this site are registered and unregistered trademarks of Kaleyra Inc.