Back to Error Codes
WhatsApp Error Codes
Complete reference of error codes returned by the WhatsApp Cloud API when messages fail to deliver. Click on any error code for detailed documentation.
Error categories
Sender issues
Problems with your business account configuration, billing, or API usage. These are issues you can typically fix.
Recipient issues
Problems on the recipient's side: their phone, app version, preferences, or WhatsApp registration status.
Platform issues
Issues on Meta's infrastructure or platform-level restrictions. Often temporary or beyond your control.
All error codes
| Code | Title | Category | Summary |
|---|---|---|---|
| 130403 | Business Has Been Blocked | Sender | Your business has been blocked from messaging on WhatsApp. |
| 130472 | Marketing Message Experiment | Recipient | The recipient is part of a Meta experiment blocking marketing messages. |
| 130497 | Country Restriction | Sender | Your account is restricted from messaging users in this country. |
| 131000 | Something Went Wrong | Platform | An unexpected internal error occurred on Meta's side. |
| 131026 | Message Undeliverable | Recipient | The message could not be delivered to the recipient. |
| 131031 | Business Account Locked | Sender | Your WhatsApp Business Account has been locked and cannot send messages. |
| 131042 | Business Eligibility Payment Issue | Sender | A payment or billing problem is preventing message delivery. |
| 131047 | Re-engagement Message Required | Sender | The 24-hour messaging window has expired. |
| 131049 | Healthy Ecosystem Limit | Platform | WhatsApp prevented delivery to maintain healthy messaging engagement. |
| 131050 | Recipient Opted Out of Marketing | Recipient | The recipient has stopped receiving marketing messages from your business. |
| 131051 | Unsupported Message Type | Sender | The message format or type is not supported by WhatsApp. |
| 131052 | Media Download Error | Platform | WhatsApp could not download the media sent by the user. |
| 131053 | Media Upload Error | Sender | WhatsApp could not upload the media for your outgoing message. |
| 131060 | Message Unavailable | Platform | The message is currently unavailable for delivery. |
Official Meta documentation
For the most up-to-date information, refer to Meta's official WhatsApp Cloud API error codes documentation.
WhatsApp Cloud API Error Codes →