WhatsApp Error Codes

Pratish JainOct 5, 20245-7 mins

whatsapp errors code

You're in the middle of an important conversation on WhatsApp, and suddenly, a WhatsApp error message pops up on your screen. There are so many different errors and I completely understand how frustrating these WhatsApp errors can be. Especially when you do not know the reason behind it and how to resolve it. 

But don't worry! In this blog, we're understanding all different WhatsApp error codes, what they mean and how to fix them.

What Are WhatsApp Error Codes?

WhatsApp error codes are basically different numbers WhatsApp has given to identif different WhatsApp errors that occur while using the app. These codes help users and developers diagnose problems and find solutions. WhatsApp errors can occur for many reasons. This ranges from connectivity issues to authentication problems, and they can affect both regular WhatsApp users and WhatsApp Business accounts.

Most Common WhatsApp Error Codes

Below are some of the most common error codes you might encounter while using WhatsApp. Each error code is listed with its meaning and possible solutions to help you resolve the issue quickly.

Regular Errors

1. Frequency Capping

Meaning: Frequency Capping puts a limit on the number of marketing messages a user can receive from brands in a specific time frame.

Solution: Wait for some time and try again. You can either do it manually or automate the process with broadcast auto-retry where in case of the above error, your message is resent to the user again after a certain period of time.

2. Backup Not Working

Meaning: Backups are essential for saving your chats, and if they aren't functioning, you might lose important messages.
Solution: Check if you have enough storage on your device and in your cloud storage (Google Drive or iCloud). Also, review your backup settings in WhatsApp.

3. Can’t Download Media

Meaning: If you can't download images or videos, it may be due to insufficient storage or app settings.
Solution: Ensure you have enough space on your device. Clear the app’s cache or adjust the media auto-download settings to fix this.

4. WhatsApp Crashing

Meaning: The app may crash due to software issues or conflicts with other applications.
Solution: Make sure you have the latest version of WhatsApp installed. Consider uninstalling any recent apps that might be causing the problem.

5. Contacts Not Synced

Meaning: Your contacts may not appear in WhatsApp if the app doesn’t have permission to access them.
Solution: Go to your phone’s settings, enable contact access for WhatsApp, and restart the app to sync your contacts.

6. Can’t Change Profile Picture

Meaning: You might face issues updating your profile picture if it doesn't meet WhatsApp’s requirements.
Solution: Ensure the image is within the allowed size and format. If it doesn’t work, clear the existing profile picture and try again.

7. WhatsApp Web Not Working

Meaning: WhatsApp Web may not function if your phone isn't connected to the internet.
Solution: Check your phone's connection, open WhatsApp, and scan the QR code on the WhatsApp Web page.

8. Video Calls Not Connecting

Meaning: Video calls may fail to connect due to internet issues or permission settings.
Solution: Ensure your internet connection is stable and check camera permissions. Restart the app or update your phone's operating system if needed.

9. Audio Messages Won’t Play

Meaning: Issues playing audio messages can arise from speaker or headphone problems.
Solution: Verify that your phone's speaker or headphones are functioning. Restart WhatsApp, and consider updating your audio drivers if necessary.

10. Can’t Change Phone Number

Meaning: Changing your phone number in WhatsApp can be challenging if the new number isn't set up correctly.
Solution: Make sure your new number is active and can receive SMS. Follow the in-app instructions carefully to update your number.

11. Notifications Not Working

Meaning: If you aren't receiving notifications, it might be due to incorrect settings.
Solution: Check both your phone's and WhatsApp's notification settings to ensure notifications are allowed.

12. Can’t Create or Join Groups

Meaning: If you're unable to create or join groups, it could be due to an outdated app version.
Solution: Ensure you are using the latest version of WhatsApp. Restart your phone, and if the issue continues, clear the app's cache.

13. WhatsApp Is Slow

Meaning: A slow WhatsApp experience might be caused by low storage or app cache buildup.
Solution: Remove unnecessary files from your device and clear the app’s cache to enhance performance.

14. Messages Disappeared

Meaning: Messages may seem to vanish, but they might just be temporarily hidden.
Solution: Check if the “Archive Chat” feature is enabled, or search for specific messages using the search bar.

15. Account Banned

Meaning: WhatsApp may ban accounts that violate its policies, leading to access issues.
Solution: If you think your account was banned unfairly, you can appeal the ban through WhatsApp’s support system to unbanned WhatsApp.

16. No Backup Found

Meaning: If you're unable to locate a backup, it may be due to using a different number or device.
Solution: Ensure you are using the same phone number and device that created the backup, and verify your cloud storage account is linked to WhatsApp.

Technical Errors

                                                                                                                                                                                                                                                 
Error CodeMeaningPossible Solution
0AuthException - Unable to authenticate the app user.Obtain a new access token if the current one has expired.
3API Method - Capability or permissions issue.Verify app permissions using the access token debugger.
4API Too Many Calls - App has reached API call rate limit.Wait and reduce the frequency of API calls.
10Permission Denied - Permission has been revoked.Check access permissions and settings.
190Access token expired - Your access token is no longer valid.Get a new access token.
131000Something went wrong - Unknown error occurred.Retry the operation. If the issue persists, contact support.
131021Recipient cannot be sender - Sender and recipient numbers are the same.Ensure sender and recipient numbers are different.
132001Template does not exist - The template is unapproved or doesn't exist.Verify template approval and name.

All WhatsApp Error Codes

Understanding all the error codes can help you diagnose issues more effectively. Below is a comprehensive list of WhatsApp error codes, categorized by type, along with their meanings and possible solutions.

Authorization Errors

                                                                                                                                         
Error CodeMeaningPossible Solution
0AuthExceptionGet a new access token if the previous one has expired or is invalid.
3API MethodVerify permissions using the access token debugger.
10Permission DeniedCheck if required permissions are granted.
190Access token has expiredGenerate a new access token.

‍Throttling Errors

                                                                                                                                                                                             
Error CodeMeaningPossible Solution
4API Too Many CallsReduce the frequency of API calls and try again later.
80007Rate limit issuesCheck your request volume and reduce it if necessary.
130429Rate limit hitReduce the message frequency and try again later.
131048Spam rate limit hitEnsure your messaging practices comply with WhatsApp policies.
131056(Business Account, Consumer Account) pair rate limit hitLimit interactions to prevent exceeding rate limits.
133016Account register deregister rate limit exceededWait and try to register or deregister later.

Integrity Errors

                                                                                                               
Error CodeMeaningPossible Solution
368Temporarily blocked for policies violationsReview policy violations and rectify them.
130497Business account is restricted from messaging users in this countryCheck local regulations regarding messaging.
131031Account has been lockedReview policy compliance and check the Health Status API for reasons.

Other Codes

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             
Error CodeMeaningPossible Solution
1API UnknownCheck the WhatsApp Business Platform Status for server issues.
2API ServiceWait and try again due to temporary downtime.
33Parameter value is not validVerify the correctness of the business phone number and parameters.
100Invalid parameterEnsure all parameters are correctly spelled and supported.
130472User's number is part of an experimentWait until the experiment concludes or opt-out if possible.
131000Something went wrongRetry after a short wait; if the issue persists, contact support.
131005Access deniedEnsure your account has the necessary permissions.
131008Required parameter is missingCheck for all required parameters and resubmit.
131009Parameter value is not validEnsure all parameter values are correct and accepted.
131016Service unavailableRetry after a short period.
131021Recipient cannot be senderVerify the sender and recipient conditions.
131026Message UndeliverableCheck the recipient's number and availability.
131042Business eligibility payment issueCheck your payment settings and ensure all accounts are active.
131045Incorrect certificateEnsure your certificate is valid and correctly installed.
131047Re-engagement messageCheck compliance with WhatsApp's re-engagement policies.
131049Meta chose not to deliverReview content for policy compliance.
131051Unsupported message typeEnsure that the message type is supported by WhatsApp.
131052Media download errorCheck network connection and media availability.
131053Media upload errorVerify file size and format compliance.
131057Account in maintenance modeWait until maintenance is complete before retrying.
132000Template Param Count MismatchEnsure the correct number of parameters in the template.
132001Template does not existCreate or verify the existence of the specified template.
132005Template Hydrated Text Too LongShorten the text to meet length requirements.
132007Template Format Character Policy ViolatedEnsure the template adheres to formatting policies.
132012Template Parameter Format MismatchCorrect any format issues with the template parameters.
132015Template is PausedReactivate the template to resume usage.
132016Template is DisabledEnable the template to allow messaging.
132068Flow is blockedReview flow settings and permissions.
132069Flow is throttledAdjust the frequency of flow executions.
133000Incomplete DeregistrationRetry the deregistration process.
133004Server Temporarily UnavailableWait and try again later.
133005Two step verification PIN MismatchVerify and input the correct PIN.
133006Phone number re-verification neededFollow the re-verification process to ensure account validity.
133008Too Many two step verification PIN GuessesWait before attempting to enter the PIN again.
133009Two step verification PIN Guessed Too FastAllow time between attempts.
133010Phone number Not RegisteredEnsure that the phone number is properly registered with WhatsApp.
133015Please wait a few minutes before attempting to register this phone numberWait for the specified time before trying again.
135000Generic user errorVerify request parameters for correctness.

Conclusion

Encountering errors while using WhatsApp can be frustrating, especially when you are left without any information of what and why is happening. By understanding these error codes, you can troubleshoot problems more efficiently and minimize downtime. Always remember to check your internet connection and ensure your app is updated to the latest version before diving into troubleshooting.

Whether you are using WhatsApp for personal chats or WhatsApp Business for your enterprise, knowing how to resolve these common errors can help you maintain seamless communication.

Learn more, arrange a call back!

Book a demo

Tell us a little about you and we'll take it from there.

Your info is private. No spam, ever.

Contact us

Tell us what you need and the right person will get back to you within one working day.

Verify your email

Enter the 4-digit code sent to

Didn't get a code?