When sending WhatsApp messages via the MsgClub panel, clients may encounter certain error codes. These errors usually relate to authorization issues, policy violations, throttling, or undeliverable messages.
In this blog, we’ve categorized the most frequent error codes, explained their meaning, and provided possible reasons with solutions. This will help you quickly identify issues and keep your campaigns running smoothly.
1. Authorization Errors
These errors occur when there’s a problem with authentication, permissions, or expired tokens.
| Code | Details | Possible reasons and solutions |
|---|---|---|
| 0 – AuthException | We were unable to authenticate the app user. | Typically this means the included access token has expired, been invalidated, or the app user has changed a setting to prevent all apps from accessing their data. We recommend that you get a new access token. |
| 3 – API Method | Capability or permissions issue. | Use the access token debugger to verify that your app has been granted the permissions required by the endpoint. See Troubleshooting. |
| 10 – Permission Denied | Permission is either not granted or has been removed. | Use the access token debugger to verify that your app has been granted the permissions required by the endpoint. See Troubleshooting.Ensure that the phone number used to set the business public key is allowlisted. |
| 190 – Access token has expired | Your access token has expired. | Get a new access token. |
| 200-299 – API Permission | Permission is either not granted or has been removed. | Use the access token debugger to verify that your app has been granted the permissions required by the endpoint. See Troubleshooting. |
2. Integrity Errors
Errors related to policy violations or account restrictions.
| Code | Details | Possible reasons and solutions |
|---|---|---|
| 368 – Temporarily blocked for policies violations | The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy. | See the Policy Enforcement document to learn about policy violations and how to resolve them. |
| 130497 – Business account is restricted from messaging users in this country. | The WhatsApp Business Account is restricted from messaging to users in certain countries. | See WhatsApp Business Messaging Policy for details on allowed countries for messaging in your business category. |
| 131031 – Account has been locked | 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). | See the Policy Enforcement document to learn about policy violations and how to resolve them.You can also use the Health Status API, which may provide additional insight into the reason or reasons for the account lock. |
3. Other Common Errors
These include server issues, invalid parameters, undeliverable messages, and template-related problems.
- 33 – Parameter value invalid → Phone number deleted, check and update.
- 100 – Invalid parameter → Misspelled/unsupported parameter; verify request formatting.
- 131026 – Message Undeliverable → Recipient not on WhatsApp, hasn’t accepted ToS, or using old version.
- 131037 – Display name approval needed → Update business display name in WhatsApp Manager.
- 132000 – Template Param Count Mismatch → Template variables don’t match request.
- 132016 – Template Disabled → Permanently disabled due to low quality; create a new one.
For the full list of error codes and solutions, refer to the WhatsApp Business documentation or your MsgClub panel help section.
4. Synchronization Errors
Occur during onboarding or syncing contacts/history.
| Code | Details | Possible reasons and solutions |
|---|---|---|
| 2593107 – Synchronization Request limit exceeded | You have exceeded the maximum number of times to call the synchronization api for this phone number. | You can only call this endpoint once to synchronize the business phone number contacts and once to synchronize its messaging history. See Onboarding business app users.Offboard the business customer and re-onboard them. |
| 2593108 – Synchronization Request made outside of allowed time window | Synchronization request can only be made within 24 hours of onboarding | You can only initiate contacts and messaging history synchronization of an onboarded WhatsApp Business app user within 24 hours of onboarding the user. See Onboarding business app users.Offboard the user and re-onboard them. |
5. Throttling & Rate Limit Errors
To maintain a healthy ecosystem, WhatsApp enforces strict limits on message throughput. Overuse or spam-like behavior can trigger these.
| Code | Details | Possible reasons and solutions |
|---|---|---|
| 4 – API Too Many Calls | The app has reached its API call rate limit. | Load the app in the App Dashboard and view the Application Rate Limit section to verify that the app has reached its rate limit. If it has, try again later or reduce the frequency or amount of API queries the app is making. |
| 80007 – Rate limit issues | The WhatsApp Business Account has reached its rate limit. | See WhatsApp Business Account Rate Limits. Try again later or reduce the frequency or amount of API queries the app is making. |
| 130429 – Rate limit hit | Cloud API message throughput has been reached. | The app has reached the API’s throughput limit. See Throughput. Try again later or reduce the frequency with which the app sends messages. |
| 131048 – Spam rate limit hit | 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. | Check your quality status in the WhatsApp Manager and see the Quality-Based Rate Limits documentation for more information. |
| 131056 – (Business Account, Consumer Account) pair rate limit hit | Too many messages sent from the sender phone number to the same recipient phone number in a short period of time. | 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 |
| 133016 – Account register deregister rate limit exceeded | Registration or Deregistration failed because there were too many attempts for this phone number in a short period of time | The business phone number is being blocked because it has reached its registration/deregistration attempt limit. Try again once the number is unblocked. See “Limitations” in the Registration document. |
Key Highlights for Clients
- Healthy Ecosystem: If a WhatsApp number receives too many promotional messages from any business, Meta may stop delivering promotional messages for some time. If you encounter this error, resend your message after two days.
- Rate Limits: Sending a very high volume of messages at once may trigger delivery errors. Retry after a few hours.
- Undelivered Messages: Customers without WhatsApp, outdated versions, or inactive numbers will not receive messages. Always verify the WhatsApp number before sending.
Conclusion
Most WhatsApp errors in MsgClub are caused by expired tokens, rate limit breaches, or undeliverable recipients. By understanding these error codes, you can troubleshoot quickly, maintain message deliverability, and ensure compliance with WhatsApp’s policies.