# 5. What are the types of error code for failed message ?

The Cloud API is built on the Graph API, so if you are unfamiliar with handling Graph API error responses, see Graph API's [error handling](https://developers.facebook.com/docs/graph-api/guides/error-handling) documentation.

In general, we recommend that you build your app's error handling logic around `code` values and `details` payload properties. These properties and their values are more indicative of the underlying error.

Code titles, which do not have a dedicated property in API error response payloads, are included as part of the `message` value. However, we recommend that you do not rely on titles for your error handling logic as titles will eventually be deprecated.

## Types of Error Codes

<table><thead><tr><th width="158">Error Code</th><th width="338">Description</th><th>Posssible Solutions</th></tr></thead><tbody><tr><td><p><code>80007</code></p><p>Rate limit issues</p></td><td>The WhatsApp Business Account has reached its rate limit.</td><td>See WhatsApp Business Account <a href="https://developers.facebook.com/docs/whatsapp/cloud-api/overview/#rate-limits">Rate Limits</a>. Try again later or reduce the frequency or amount of API queries the app is making.</td></tr><tr><td><p><code>131048</code></p><p>Spam rate limit hit</p></td><td>Message 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.</td><td>Check your quality status in the WhatsApp Manager and see the <a href="https://developers.facebook.com/docs/whatsapp/messaging-limits#quality-rating-and-messaging-limits">Quality-Based Rate Limits</a> documentation for more information.</td></tr><tr><td><p><code>131056</code></p><p>(Business Account, Consumer Account) pair rate limit hit</p></td><td>Too many messages sent from the sender phone number to the same recipient phone number in a short period of time.</td><td>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</td></tr><tr><td><p><code>368</code></p><p>Temporarily blocked for policies violations</p></td><td>The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy.</td><td>See the <a href="https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement/">Policy Enforcement</a> document to learn about policy violations and how to resolve them.</td></tr><tr><td><p><code>131031</code></p><p>Account has been locked</p></td><td>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).</td><td><p>See the <a href="https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement/">Policy Enforcement</a> document to learn about policy violations and how to resolve them.</p><p><br></p><p>You can also use the <a href="https://developers.facebook.com/docs/whatsapp/cloud-api/health-status">Health Status API</a>, which may provide additional insight into the reason or reasons for the account lock.</p></td></tr><tr><td><p><code>100</code></p><p>Invalid parameter</p></td><td>The request included one or more unsupported or misspelled parameters.</td><td><p>See the endpoint's <a href="https://developers.facebook.com/docs/whatsapp/cloud-api/reference">reference</a> to determine which parameters are supported and how they are spelled.</p><p>Ensure when setting the business public key, it is a <a href="https://developers.facebook.com/docs/whatsapp/cloud-api/reference/whatsapp-business-encryption#gen">valid 2048-bit RSA public key in PEM format</a>.</p><p>Ensure there is no mismatch between the phone number id you are <a href="https://developers.intern.facebook.com/docs/whatsapp/cloud-api/reference/registration#register-phone">registering</a> and a previously stored phone number id.</p></td></tr><tr><td><p><code>130472</code></p><p>User's number is part of an experiment</p></td><td>Message was not sent as part of an <a href="https://developers.facebook.com/docs/whatsapp/cloud-api/guides/experiments">experiment</a>.</td><td>See <a href="https://developers.facebook.com/docs/whatsapp/cloud-api/guides/experiments#marketing-message-experiment">Marketing Message Experiment</a>.</td></tr><tr><td><p><code>131000</code></p><p>Something went wrong</p></td><td><p>Message failed to send due to an unknown error.</p><p>When <a href="https://developers.facebook.com/docs/whatsapp/cloud-api/reference/whatsapp-business-encryption#set-business-public-key">setting a business public key</a>, it either failed to calculate the signature, call the GraphQL endpoint, or the GraphQL endpoint returned an error.</p></td><td>Try again. If the error persists, open a <a href="https://business.facebook.com/direct-support">Direct Support</a> ticket.</td></tr><tr><td><p><code>131026</code></p><p>Message Undeliverable</p></td><td><p></p><p>Unable to deliver message. Reasons can include:</p><ul><li>The recipient phone number is not a WhatsApp phone number.</li><li>Sending an <a href="https://developers.facebook.com/docs/whatsapp/business-management-api/authentication-templates">authentication template</a> to a WhatsApp user who has a +91 country calling code (India). Authentication templates currently cannot be sent to WhatsApp users in India.</li><li>Recipient has not accepted our new Terms of Service and Privacy Policy.</li><li><p>Recipient using an old WhatsApp version; must use the following WhatsApp version or greater:</p><ul><li>Android: 2.21.15.15</li><li>SMBA: 2.21.15.15</li><li>iOS: 2.21.170.4</li><li>SMBI: 2.21.170.4</li><li>KaiOS: 2.2130.10</li><li>Web: 2.2132.6</li></ul></li><li>The message was not delivered to create a high quality user experience. See <a href="https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates#per-user-marketing-template-message-limits">Per-User Marketing Template Message Limits</a>.</li></ul></td><td><p></p><p>Using a non-WhatsApp communication method, ask the WhatsApp user to:</p><ul><li>Confirm that they can actually send a message to your WhatsApp business phone number.</li><li>Confirm that your WhatsApp business phone number is not in their list of blocked numbers (<strong>Settings</strong> > <strong>Privacy</strong> > <strong>Blocked</strong> or <strong>Blocked contacts</strong>).</li><li>Confirm that they have accepted our latest Terms of Service (<strong>Settings</strong> > <strong>Help</strong>, or <strong>Settings</strong> > <strong>Application information</strong> will prompt them to accept the latest terms/policies if they haven't done so already)</li><li>Update to the latest version of the WhatsApp client.</li></ul></td></tr><tr><td><p><code>131047</code></p><p>Re-engagement message</p></td><td>More than 24 hours have passed since the recipient last replied to the sender number.</td><td>Send the recipient a business-initiated message using a <a href="https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates">message template</a> instead.</td></tr><tr><td><p><code>132001</code></p><p>Template does not exist</p></td><td>The template does not exist in the specified language or the template has not been approved.</td><td>Make sure your template has been approved and the template name and language locale are correct. Please ensure you follow <a href="https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/">message template guidelines</a>.</td></tr><tr><td><p><code>135000</code></p><p>Generic user error</p></td><td>Message failed to send because of an unknown error with your request parameters.</td><td>See the endpoint's <a href="https://developers.facebook.com/docs/whatsapp/cloud-api/reference/">reference</a> to determine if you are querying the endpoint using the correct syntax. Contact <a href="https://developers.facebook.com/support/">customer support</a> if you continue receiving this error code in response.</td></tr></tbody></table>
