Standard Errors
When a WhatsApp message fails, the status report on your status report webhook contains a CM.com error code in errorCode and a description in errorDescription. For WhatsApp, CM.com maps the errors reported by Meta to the codes below. For the structure of status reports and the errors that apply to all channels, see Incoming status reports.
Each Meta error code links to the relevant section of Meta's error code reference, which describes possible causes and solutions in detail.
Error codes
| CM.com code | Meta code | Description |
|---|---|---|
| 51 | 1 | An unknown error has occurred. |
| 52 | 10 | The application does not have permission for this action. |
| 53 | 100 | Invalid parameter. |
| 54 | 130472 | The message was not sent because the user's phone number is part of an experiment. |
| 55 | 131000 | Something went wrong. |
| 56 | 131008 | A required parameter is missing. |
| 57 | 131009 | A parameter is not valid. |
| 58 | 131021 | You cannot send a message to yourself. |
| 59 | 131026 | Message undeliverable. |
| 60 | 131031 | The business account has been locked. |
| 61 | 131042 | The message was not sent because of one or more errors related to your payment method. |
| 62 | 131047 | More than 24 hours have passed since the user last messaged this number. Use a template to re-engage the user. |
| 63 | 131048 | Spam rate limit hit. |
| 64 | 131053 | Media upload error. Check that the file meets the media requirements. |
| 65 | 131056 | Pair rate limit hit: too many messages from your business number to the same user in a short period. |
| 66 | 132000 | The number of parameters does not match the number of variables in the template. |
| 67 | 132001 | The template does not exist in the specified language. |
| 68 | 132005 | The translated text is too long. |
| 69 | 132012 | The parameter format does not match the format in the template. |
| 73 | 131049 | The message was not delivered because of Meta's marketing message limits. |
| 74 | 131050 | The user has chosen to stop receiving marketing messages from your business. |
| 77 | 80007 | The WhatsApp Business Account has reached its rate limit. |
| 78 | 130429 | Throughput limit reached. Try again later or reduce your sending rate. |
| 79 | 131037 | The display name of your WhatsApp number must be approved before you can send messages. |
| 80 | 132015 | Template paused because of low quality. Edit the template to improve its quality and try again once it is approved. |
| 81 | 132016 | Template disabled: it was paused too many times because of low quality. Create a new template with different content. |
| 82 | 132068 | The Flow is blocked. Correct the Flow and try again. |
| 83 | – | The message expired because the WhatsApp validity period (TTL) was exceeded. See Meta's documentation on customising the TTL and Time-to-live. |
Errors by category
Use this overview to decide how to handle an error in your integration.
| Category | CM.com codes | Recommended handling |
|---|---|---|
| Request errors | 53, 56, 57, 58, 66, 67, 68, 69 | Fix the request. Retrying the same request will fail again. |
| Throttling | 63, 65, 73, 77, 78 | Retry later with back-off, or reduce your sending rate. |
| Customer service window | 62 | Send a template message instead. |
| User preference | 74 | Do not retry. Respect the user's choice. |
| Account and template | 52, 60, 61, 79, 80, 81, 82 | Resolve the issue in your account or template setup. Contact CM.com Support if needed. |
| Delivery | 54, 59, 83 | The message could not be delivered to this user. |
| Unknown | 51, 55 | Retry once. If the error persists, contact CM.com Support. |