The WhatsApp Business API, though powerful, isn’t immune to occasional hiccups. Error codes can pop up when something isn’t working as expected, leaving you scrambling for answers.

This guide is here to make things easier. It breaks down Meta’s WhatsApp API error codes one by one, explains what they mean, and provides simple steps to fix them. 

If you’ve been searching for a straightforward way to troubleshoot these errors and keep your business communication on track, this resource has got you covered. Let’s get started!

Tip: Bookmark this blog to take a look at the solution to any error code quickly.

Error Code 0: Auth Exception

Error message: We were unable to authenticate the app user.

AuthException (Error Code 0) signals that your app couldn't authenticate the user, commonly due to:

  • Access token expired.

  • Access token invalidated.

  • The user changed settings to restrict app access.

You need to generate a new access token to replace the expired or invalidated one, and update it in your system and confirm that the user has granted your app the required permissions.

For a step by step solution to troubleshoot WhatsApp API Error Code 0, check out this blog on Troubleshooting WhatsApp Business API Error Code 0: AuthException.

Error Code 3: API Method

Error message: Capability or permissions issue.

Error Code 3 signifies that the app is facing restrictions due to missing permissions. The server response shows a 500 Internal Server Error, meaning the issue is within the application’s configuration rather than the server.

To resolve this error you need to go to the Access Token Debugger and paste your access token to verify if the required permissions (whatsapp_business_management and whatsapp_business_messaging) are enabled. ​If your token doesn’t include these permissions, you’ll need to create a new one.

For a step by step solution to troubleshoot WhatsApp API Error Code 3, check out this blog on Troubleshooting WhatsApp Business API Error Code 3: Capability or Permissions Issue.

Error Code 10: Permission Denied

Error message: Permission is either not granted or has been removed.

Error Code 10 means that permission for the requested action is either not granted to the app or has been removed from the app’s access.

To resolve this error you need to go to the Access Token Debugger and paste your access token to verify if the required permissions (whatsapp_business_management and whatsapp_business_messaging) are enabled. ​If your token doesn’t include these permissions, you’ll need to create a new one. You also need to ensure that the phone number used to set the business public key is allowlisted.

For a step by step solution to troubleshoot WhatsApp API Error Code 10, check out this blog on Troubleshooting WhatsApp Business API Error Code 10: Permission Denied.

Error Code 190: Access token has expired

Error message: Your access token has expired.

Error Code 190 indicates that your access token has expired, resulting in a 401 Unauthorized status. This error prevents API access until a new token is generated. To resolve this error you need to generate a new system user token.

For a step by step solution to troubleshoot WhatsApp API Error Code 190, check out this blog on Troubleshooting WhatsApp Business API Error Code 190: Access Token Expired.

Error Code 200-299: API Permission

Error message: Permission is either not granted or has been removed.

Error Code 200-299 (API Permission) with a 403 Forbidden status means that the app doesn’t have the required permissions to access specific API features or permissions were previously granted but were later removed or revoked.

To resolve this error you need to go to the Access Token Debugger and paste your access token to verify if the required permissions (whatsapp_business_management and whatsapp_business_messaging) are enabled. ​If your token doesn’t include these permissions, you’ll need to create a new one. 

For a step by step solution to troubleshoot WhatsApp API Error Code 200-299, check out this blog on Troubleshooting WhatsApp Business API Error Code 200-299: API Permission.

Error Code 4: API Too Many Calls

Error message: The app has reached its API call rate limit.

Error Code 4 occurs when your app exceeds its allocated rate limit for API calls, tracked on an hourly basis. Each request you make to the WhatsApp Business Management API counts toward this limit, which affects actions related to message templates, phone numbers, and your WhatsApp Business Account (WABA). Your app’s call count is the number of requests allowed per hour, calculated based on activity. Here’s a breakdown of the rate limits:

  • For all apps, the default rate limit is 200 calls per hour per app, per WABA.

  • Apps linked to an active WABA with at least one registered phone number can make up to 5000 calls per hour per app, per WABA.

For a step by step solution to troubleshoot WhatsApp API Error Code 4, check out this blog on Resolving WhatsApp Business API Error Code 4: Too Many Calls.

Error Code 130429: Rate Limit Hit

Error message: Cloud API message throughput has been reached.

Error Code 130429 is triggered when the API’s throughput limit is exceeded. Throughput is the rate at which messages can be sent per second. The Cloud API allows up to:

    • 80 messages per second (mps) by default for each registered business phone number.

    • 1,000 mps for eligible accounts that are automatically upgraded.

    Throughput includes all message types, both incoming and outgoing. When you exceed this rate, the API temporarily blocks further requests.

    For a step by step solution to troubleshoot WhatsApp API Error Code 130429, check out this blog on Resolving WhatsApp Business API Error Code #130429: Throughput Reached.

    Error Code 131048: Spam Rate Limit Hit

    ​Error Message: 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.

    When customers block or report your messages as spam, your account’s quality rating can drop. Once this happens, WhatsApp imposes restrictions to control the number of messages you can send, helping to maintain a positive user experience on the platform.

    For a detailed explanation on how quality rating works and a step by step solution to troubleshoot WhatsApp API Error Code 131048, check out this blog on Troubleshooting WhatsApp Business API Error Code #131048: Spam Rate Limit Hit.

    Error Code 131056: (Business Account, Consumer Account) pair rate limit hit

    Error message: Too many messages sent from the sender phone number to the same recipient phone number in a short period of time.

    The pair rate refers to the number of messages that can be sent from your business phone number to a specific customer phone number within a defined time period. WhatsApp’s system limits how many messages a business can send to the same customer in a short span of time to avoid spamming the user. If the message limit is exceeded, this error is triggered. When you hit the pair rate limit, you are temporarily restricted from sending messages to that particular customer number. The error message suggests that you wait before trying again. However, you can still send messages to other phone numbers without any issues. If you're running a marketing campaign or providing support, you can focus on engaging other users without delay.

    For a step by step solution to troubleshoot WhatsApp API Error Code 131056, check out this blog on How to Resolve WhatsApp Business API Error Code 131056: Pair Rate Limit Hit.

    Error Code 133016: Account register deregister rate limit exceeded

    Error Message: Registration or Deregistration failed because there were too many attempts for this phone number in a short period of time.

    This error happens when too many registration or deregistration requests are made for the same phone number in a short time. WhatsApp Business API imposes a limit of 10 requests per business number within a 72-hour moving window. If this limit is reached, the system blocks further registration attempts for the next 72 hours. This measure is in place to prevent abuse and ensure that phone numbers are not repeatedly registered or deregistered in rapid succession, which could cause system instability or misuse.

    For a step by step solution to troubleshoot WhatsApp API Error Code 131056, check out this blog on WhatsApp Business API Error Code 133016: Account Register Deregister Rate Limit Exceeded.

    Error Code 368: Temporarily blocked for policies violations

    Error Message: The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy.

    This error indicates your WhatsApp Business Account has been restricted or disabled for violating policies such as the WhatsApp Business Messaging Policy, the WhatsApp Commerce Policy, or the WhatsApp Business Terms of Service. Depending on the severity and frequency of violations, your account may face:

    1. Temporary Messaging Restrictions: 1 to 30-day blocks on initiating conversations.

    2. Account Lock: Indefinite block, requiring an appeal to unlock.

    3. Permanent Disablement: For severe violations, such as scams or illegal activities.

    For a step by step solution to troubleshoot WhatsApp API Error Code 131056, check out this blog on Error 368: Temporarily Blocked for Policy Violations on WhatsApp Business API [All You Need to Know].

    Error Code 130497: Business account is restricted from messaging users in this country

    Error Message: The WhatsApp Business Account is restricted from messaging to users in certain countries.

    Error 130497 often stems from the promotion of regulated or restricted goods and services that WhatsApp prohibits or limits based on their policies. WhatsApp prohibits businesses from promoting specific goods and services globally, even if those goods are legal in certain regions. Additionally, messaging for some regulated items is only permitted in specific countries where local laws allow such practices.

    To learn about WhatsApp API Error 130497 in detail and how to troubleshoot it check out this blog on Understanding Error Business Account Restricted from Messaging Users in This Country (130497) on WhatsApp Business API.

    Error Code 131031: Account has been locked

    Error Message: 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).

    Error Code 131031 means that your account has been restricted or disabled due to policy violations or discrepancies in the verification process. Your account might have been locked for breaching WhatsApp’s platform policies like sending spam or inappropriate messages, promoting restricted or prohibited goods/services or receiving excessive user complaints

    The account lock can also occur if WhatsApp cannot verify the data in your request, such as an incorrect two-step PIN or mismatch between submitted details and account information. 

    You need to diagnose the violation by Checking Violation Details at Business Support Home. If the Business Support Home shows a policy violation that you feel can be appealed, you can proceed to request a review. When a business submits an appeal for a violation, the WhatsApp team evaluates it against their policies to determine whether the violation should be reconsidered. This process may lead to the violation being overturned.

    For a step by step solution to troubleshoot WhatsApp API Error Code 131031, check out this blog on Resolving Error Account Has Been Locked Error (131031) on WhatsApp Business API.

    Error Code 1: API Unknown

    Error Message: Invalid request or possible server error.

    The ‘1: API Unknown Error’ on WhatsApp API occurs when either your API request is not formatted correctly or fails to meet endpoint requirements or there’s a temporary issue or outage on WhatsApp's servers. 

    You first need to visit the WhatsApp Business Platform Status page to confirm if there’s an ongoing server issue. If an outage is reported, wait for WhatsApp to resolve it before retrying. If there is no outage then double-check the API endpoint you’re using. Ensure it matches the intended action. Verify that all required parameters are included and formatted correctly.

    For a step by step solution to troubleshoot WhatsApp API Error Code 1, check out this blog on Understanding the API Unknown - Invalid Request or Possible Server Error (Error Code 1).

    Error Code 2: API Service

    Error Message: Temporary due to downtime or due to being overloaded.

    Error Code 2 indicates that the WhatsApp Business Platform is temporarily unavailable due to service downtime or being overloaded with requests. This issue is typically temporary and resolves on its own and you cannot really do anything to make it go away. You can visit the WhatsApp Business Platform Status page to confirm whether there is a known service outage or maintenance.

    To understand WhatsApp API Error Code 2 in detail check out this blog on Resolving the API Service - Temporary Downtime or Overload Error (Error Code 2) on WhatsApp.

    Error Code 33: Parameter value is not valid

    Error Message: The business phone number has been deleted.

    The ‘33: Parameter Value Is Not Valid’ error occurs when the business phone number in your API request has been deleted or is no longer valid or the phone number entered in the API request was incorrect.

    To resolve this error you first need to confirm the listed phone numbers under the associated WhatsApp Business Account. If the number is incorrect you need to update your API call to include a correct valid number.

    For a step by step solution to troubleshoot WhatsApp API Error Code 33, check out this blog on Resolving the Parameter Value Is Not Valid Error (Error Code 33) on WhatsApp API.

    Error Code 100: Invalid Parameter

    Error Message: The request included one or more unsupported or misspelled parameters.

    This error arises when:

    1. You’ve included parameters that are either not supported by the API endpoint or contain spelling mistakes.

    2. When setting up the business public key, it doesn’t meet the required format: a valid 2048-bit RSA public key in PEM format.

    3. The phone_number_id in your request does not match the one previously registered.

    4. One or more parameters exceed the maximum allowed length for their type.

    For a detailed step by step solution to troubleshoot WhatsApp API Error Code 100, check out this blog on Troubleshooting WhatsApp API Error: "Invalid Parameter" (Error Code 100).

    Error Code 130472: User's number is part of an experiment

    Error Message: Message was not sent as part of an experiment.

    Starting June 14, 2023, WhatsApp began running a Marketing Message Experiment affecting roughly 1% of users. Under this experiment marketing template messages are not delivered to users in the test group unless at least one of these conditions is met:

      • The customer must have messaged your business within the last 24 hours.

      • A marketing message conversation must already be ongoing with the customer.

      • The customer initiated contact via a free-entry point, such as a Click-to-WhatsApp ad or link.

      If your message is blocked as part of the experiment, you receive a webhook with error code #130472, and the message will be marked as undeliverable. You are not billed for undelivered messages, and resending the message will result in the same error. WhatsApp cannot provide exceptions or opt-outs for users in the experiment group and attempting to resend the message will not bypass the restriction. However, as the experiment applies to a very small percentage of users, most of your messages will still go through.

      To know more about WhatsApp API Error 130472, check out this blog on WhatsApp API Error 130472: User's Number is Part of an Experiment [Everything You Need to Know].

      Error Code 131000: Something went wrong

      Error Message: Message failed to send due to an unknown error. When setting a business public key, it either failed to calculate the signature, call the GraphQL endpoint, or the GraphQL endpoint returned an error.

      Error 131000 generally occurs when:

      1. The API was unable to process the signature when setting a business public key.

      2. The request to the GraphQL endpoint failed.

      3. The GraphQL endpoint responded with an error.

      While there is no exact solution prescribed by Meta there is a workaround that has been working for a few clients. Ask your Business Service Provider to create a new app in the developer console, where you'll input your phone numbers and templates. After that, simply reconfigure your permanent token and webhook. This has resolved the issue for a lot of people.

      For detailed steps to resolve Error 131000, check out this blog on Troubleshooting WhatsApp API Error 131000: Something Went Wrong [Working Fix 2025].

      Error Code 131005: Access denied

      Error Message: Permission is either not granted or has been removed.

      Error code 131005 with the message "Access Denied" means your app does not have the necessary permissions to perform the requested action.

      To resolve this error you need to check if your token includes the following permissions whatsapp_business_management and whatsapp_business_messaging. If these permissions are missing, proceed to generate a new access token.

      For a detailed step by step solution to resolve Error Code 131005, check out this blog on Troubleshooting WhatsApp API Error 131005: Access Denied.

      Error Code 131008: Required parameter is missing

      Error Message: The request is missing a required parameter.

      Error 131008 occurs when a required parameter is not included in your API request. This is a common issue that can be easily resolved by ensuring all necessary parameters are included in your request.

      For a step by step solution to resolve WhatsApp API Error Code 131008, check out this blog on Troubleshooting WhatsApp API Error 131008: Required Parameter is Missing.

      Error Code 131009: Parameter value is not valid

      Error Message: One or more parameter values are invalid.

      Error 131009 occurs when either the values you’ve provided for one or more parameters do not meet the expected format or requirements or the phone number used in the request has not been added to your WhatsApp Business Account.

      To resolve this error visit the official WhatsApp API documentation for the endpoint you are using and verify that each parameter in your request has a valid and correct value. Also confirm that the phone number in your request has been added to your WhatsApp Business Account.

      For a step by step solution to resolve WhatsApp API Error Code 131009, check out this blog on Troubleshooting WhatsApp API Error 131009: Parameter Value Is Not Valid.

      Error Code 131016: Service unavailable

      Error Message: A service is temporarily unavailable.

      This error occurs when a WhatsApp service is temporarily unavailable due to planned maintenance or unexpected issues affecting the WhatsApp Business API or temporary unavailability of services in specific regions.

      There is nothing you can do to resolve this error. You can Check the WhatsApp Business Platform Status page to see API status information before trying again.

      For more details about WhatsApp API Error Code 131016, check out this blog on Understanding WhatsApp API Error 131016: Service Unavailable.

      Error Code 131021: Recipient Cannot Be Sender

      Error Message: Sender and recipient phone number is the same.

      Error 131021 occurs when the sender and recipient phone numbers are the same. To prevent this error, for testing use a separate phone number or a dedicated testing number instead of your sender number. Validate phone numbers in your application to prevent accidental use of the sender’s number as the recipient.

      To know more about WhatsApp API Error Code 131021, check out this blog on Troubleshooting WhatsApp API Error 131021: Recipient Cannot Be Sender.

      Error Code 131026: Message Undeliverable Error

      Error Message: Unable to deliver message. Reasons can include:

      • The recipient phone number is not a WhatsApp phone number.

      • Sending an authentication template to a WhatsApp user who has a +91 country calling code (India). Authentication templates currently cannot be sent to WhatsApp users in India.

      • Recipient has not accepted our new Terms of Service and Privacy Policy.

      • Recipient using an old WhatsApp version; must use the following WhatsApp version or greater:

        • Android: 2.21.15.15

        • SMBA: 2.21.15.15

        • iOS: 2.21.170.4

        • SMBI: 2.21.170.4

        • KaiOS: 2.2130.10

        • Web: 2.2132.6

      As mentioned in the error message, there could be several reasons for the occurrence of this error. For detailed step by step solution to help you inspect the error and debug it check out this blog on Troubleshooting #131026 Message Undeliverable Error in WhatsApp Business API.

      Error Code 131037: WhatsApp provided number needs display name approval before message can be sent.

      Error Message: The 555 business phone number used to send the request does not have an approved display name.

      Error Code 131037 occurs if the business phone number you’re using does not have a display name set or the display name you’ve provided is not yet approved by WhatsApp. Before setting a display name, ensure it meets WhatsApp’s guidelines. If you work with a Business Service Provider (BSP), they will manage the display name setup and approval process. Contact your BSP for assistance. If not check out detailed steps to fix this error in this blog on Troubleshooting WhatsApp API Error 131037: Display Name Approval Required.

      Error Code 131042: Business eligibility payment issue

      Error Message: There was an error related to your payment method.

      Error Code 131042 occurs when one or more of the following issues are present:

      1. The payment account isn’t linked to your WhatsApp Business Account.

      2. Your payment account has exceeded its credit limit.

      3. The credit line for the payment account is inactive or not set.

      4. Your WhatsApp Business Account is deleted or suspended.

      5. Your timezone or currency settings are missing or incorrectly set.

      6. Your request to send messages on behalf of another account is pending or declined.

      7. You’ve exceeded the free message tier without providing a valid payment method.

      For detailed steps to fix WhatsApp API Error Code 131042 check out this blog on Troubleshooting WhatsApp API Error 131042: Business Eligibility Payment Issue.

      Error Code 131045: Incorrect certificate

      Error Message: Message failed to send due to a phone number registration error.

      Error Code 131045 occurs when the phone number you’re using hasn’t been registered properly with the WhatsApp Business API or the certificate required for phone number registration is incorrect or missing. For detailed steps to fix this error check out this blog on Troubleshooting WhatsApp API Error 131045: Incorrect Certificate.

      Error Code 131047: Re-engagement message

      Error Message: More than 24 hours have passed since the recipient last replied to the sender number.

      Error code 131047 occurs when you attempt to send a regular message to a recipient after 24 hours have passed since their last reply. Whenever a customer sends you a message, a 24-hour window opens. During this time, you can send free-form messages back and forth with the customer without needing to use pre-approved templates. The window refreshes every time the customer sends a new message. Once the window closes, you will need to use a template to reach out to the customer again.

      For more information about WhatsApp API Error Code 131047 check out this blog on Troubleshooting WhatsApp API Error 131047: Re-Engagement Message Required.

      Error Code 131049: Meta chose not to deliver.

      Error Message: This message was not delivered to maintain healthy ecosystem engagement.

      This error usually pops up when a user has received too many marketing messages from businesses within a specific timeframe. This cap for each user adapts based on factors such as how many messages the user has already received or whether they've interacted with previous ones. For example, if six businesses have sent marketing messages to a user within a certain time frame, WhatsApp may block a seventh business from sending a marketing message, even if that business is reaching out to this user for the first time and throw the #131049 Error. Constantly trying to send messages will not solve the problem in this case. As the cap is not permanent, try sending marketing messages at increasing intervals (e.g., after two days, then a week, and so on). If you have something urgent to communicate, consider sending a utility message as they are not affected by Frequency Capping.

      To read about WhatsApp API Error Code 131049 and its troubleshooting methods in detail check out this blog on Troubleshooting #131049 Message Not Delivered to Maintain a Healthy Ecosystem Error: What You Need to Know.

      Error Code 131051: Unsupported message type

      Error Message: Unsupported message type.

      Error code 131051 occurs when you attempt to send a message type that is not supported by the WhatsApp Business API. Check the WhatsApp API documentation for the latest list of supported message types to resolve the error.

      To read about WhatsApp API Error Code 131051 in detail check out this blog on Troubleshooting WhatsApp API Error 131051: Unsupported Message Type.

      Error Code 131052: Media download error

      Error Message: Unable to download the media sent by the user.

      Error code 131052 on WhatsApp Business API  indicates that the media file sent by a WhatsApp user could not be downloaded. This error occurs when:

      1. The media file included in the user's message is inaccessible or corrupted.

      2. There are issues with the API attempting to download the media.

      3. Network or permissions-related problems prevent successful media retrieval.

      Detailed steps to debug this error have been explained in the blog Troubleshooting WhatsApp API Error 131052: Media Download Error.

      Error Code 131053: Media upload error

      Error Message: Unable to upload the media used in the message.

      Error code 131053 occurs when the WhatsApp API fails to upload a media file. The error can happen due to:

      1. Unsupported media type or format.

      2. Corrupted or invalid media file.

      3. Large file size exceeding WhatsApp’s limits.

      4. Incorrect API configuration for handling media uploads.

      Detailed steps to debug this error have been explained in the blog Troubleshooting WhatsApp API Error 131053: Media Upload Error.

      Error Code 131057: Account in maintenance mode

      Error Message: Business Account is in maintenance mode.

      Error code 131057 occurs when your WhatsApp Business Account enters maintenance mode. When your account is in maintenance mode, it means:

      1. The account is temporarily unavailable for use.

      2. It may be undergoing system updates or a throughput upgrade. In case of throughput upgrade your account will return to normal functionality within a few minutes.

      Maintenance mode is usually brief and most accounts are restored to full functionality within minutes. If your account remains in maintenance mode for an extended period, contact WhatsApp Business Support through your Meta Business Manager.

      For details about WhatsApp API Error Code 131057 check out this blog on Troubleshooting WhatsApp API Error 131057: Account in Maintenance Mode.

      Error Code 132000: Template Param Count Mismatch

      Error Message: The number of variable parameter values included in the request did not match the number of variable parameters defined in the template.

      Error code 132000 occurs when the number of variable parameters in your message request does not match the number defined in your template. The message template requires a specific number of variable parameters, but your request includes fewer or extra values. If the error persists, check the payload structure. Make sure the components object is nested properly inside the template object. An incorrectly structured payload can trigger this error.

      For detailed fix to the error code 132000, along with an example of corrected payload, check out the blog WhatsApp API Error 132000: Template Param Count Mismatch [Working Fix].

      Error Code 132001: Template does not exist

      Error Message: The template does not exist in the specified language or the template has not been approved.

      Error code 132001 occurs due to the following reasons:

      1. The template name in your API request does not match the name in WhatsApp Business Manager.

      2. The language specified in your request is not available for the template.

      3. The template has not yet been approved by WhatsApp yet.

      4. Templates that were recently created or updated may take some time to become usable.

      For detailed steps to resolve Error 132001 check out this blog on Troubleshooting WhatsApp API Error 132001: Template Does Not Exist.

      Error Code 132005: Template Hydrated Text Too Long

      Error Message: Translated text is too long.

      Error code 132005 occurs when the text in your message template exceeds the allowed character limit after the variables (e.g., { {1} }, { {2} }) are replaced with actual values. The placeholder variables in your template ({ {1} }, { {2} }) expand into large chunks of text and the message becomes too long once variables are replaced with actual values pushing the total character count beyond the limit. Although the system may let you create the template and even send it, it fails due to Meta’s character limit policies and you get the error 132005. To resolve this error rephrase or shorten the base template text or limit the length of the variable content by ensuring inputs are concise.

      For detailed explanation of Error 132005 and its solution with example check out this blog on WhatsApp API Error 132005: Template Hydrated Text Too Long [Simplified Working Fix].

      Error Code 132007: Template Format Character Policy Violated

      Error Message: Template content violates a WhatsApp policy.

      Error code 132007 occurs when the content of your message template violates WhatsApp’s policies, leading to its rejection. To resolve this error you first need to review the rejection details on the rejection notification email or at Business Support Home. Then make corrections according to the reason specified for template rejection.

      For step by step solution to Error 132007 check out this blog on Troubleshooting WhatsApp API Error 132007: Template Format Character Policy Violated.

      Error Code 132012: Template Parameter Format Mismatch

      Error Message: Variable parameter values formatted incorrectly.

      Error 132012 occurs when the variable parameter values in your API request do not match the format specified in your approved message template. To resolve this error identify the variable placeholders (e.g., { {1} }) in the approved message template and confirm their expected data types (e.g., text, image, video).

      For a more detailed explanation of this error check out this blog on Troubleshooting WhatsApp API Error 132012: Template Parameter Format Mismatch.

      Error Code 132015: Template is Paused

      Error Message: Template is paused due to low quality so it cannot be sent in a template message.

      Error 132015 occurs when a message template has been paused due to low quality, preventing it from being sent. Each message template has a quality rating based on factors such as customer feedback (e.g., complaints or blocking) and engagement rates (e.g., response or open rates). If a template continuously receives negative feedback or low engagement, its status will change. When a template’s quality drops too low, it will be paused to prevent further degradation. 

      For detailed steps to resolve this error check out this blog on Understanding WhatsApp API Error 132015: Template is Paused.

      Error Code 132016: Template is Disabled

      Error Message: Template has been paused too many times due to low quality and is now permanently disabled.

      Error 132016 occurs when a message template is permanently disabled because it was paused too many times due to low quality.  If a template receives consistently negative feedback or low engagement, it goes through the following stages:

      1. Active – Low Quality: The template is flagged for poor performance.

      2. Paused: Temporarily disabled to protect quality ratings.

      3. Disabled: If paused multiple times, the template is permanently deactivated.

      If a template is paused multiple times, it progresses through specific durations:

      1st Pause: 3 hours.

      2nd Pause: 6 hours.

      3rd Pause: Permanently disabled.

      Once disabled, the template cannot be restored or reactivated. Since a disabled template cannot be used again, you need to create a new one with revised content. Review what caused the low-quality rating to avoid repeating mistakes.

      To understand Error 132016 and its fix in detail check out this blog on Understanding WhatsApp API Error 132016: Template is Disabled.

      Error Code 132068: Flow is Blocked

      Error Message: Flow is in blocked state.

      Error 132068 on WhatsApp Business API indicates that the flow associated with your request is currently in a blocked state and cannot proceed. A flow may be blocked due to issues in its configuration, such as:

      • Missing or invalid inputs in the flow.

      • Logical errors or incomplete steps in the flow setup.

      • Dependency on other actions or events that haven’t been triggered.

      For steps to troubleshoot Error 132068 check out this blog on Resolving WhatsApp API Error 132068: Flow is Blocked.

      Error Code 132069: Flow is throttled

      Error Message: Flow is in throttled state and 10 messages using this flow were already sent in the last hour.

      Error 132069 means the flow has been flagged as unhealthy due to endpoint issues or screen navigation metrics deteriorating. When a Flow is throttled:

      • It can still be opened and used to send messages, but the limit is capped at 10 messages per hour.

      • If the metrics do not improve, the Flow may eventually be blocked.

      For a step by step solution to fix throttled flow check out this blog on Resolving WhatsApp API Error 132069: Flow is Throttled.

      Error Code 133000: Incomplete Deregistration

      Error Message: A previous deregistration attempt failed.

      Error 133000 occurs when a previous attempt to deregister a business phone number from the WhatsApp Business API has failed. Before you can proceed with registering the number again, you need to complete the deregistration process successfully.

      For step by step solution to troubleshoot Error 133000 check out this blog on Troubleshooting WhatsApp API Error 133000: Incomplete Deregistration.

      Error Code 133004: Server Temporarily Unavailable

      Error Message: Server is temporarily unavailable.

      Error 133004 with the message Server Temporarily Unavailable typically arises when the WhatsApp Business API server is inaccessible. This is often a temporary issue, and services usually resume within a short time. Most of the time, this issue resolves on its own once the server is back online. Visit the WhatsApp Business Platform Status Page to check API status information and see the response details value before trying again. If sending a message to a user is urgent, use alternate channels of communication. 

      To read more about this error check out this blog on Understanding WhatsApp API Error 133004: Server Temporarily Unavailable.

      Error Code 133005: Two step verification PIN Mismatch

      Error Message: Two-step verification PIN incorrect.

      Error 133005 occurs when the two-step verification PIN provided in your request does not match the PIN configured for the phone number. Ensure that the two-step verification PIN you’re including in your request matches the one configured for the WhatsApp Business Account (WABA).

      For a step by step solution to fix WhatsApp API Error Code 133005 check out this blog on Troubleshooting WhatsApp API Error 133005: Two-Step Verification PIN Mismatch.

      Error Code 133006: Phone number re-verification needed

      Error Message: Phone number needs to be verified before registering.

      Error 133006 indicates that a phone number must be verified before it can be registered for use with the WhatsApp Business API. For a step by step guide to resolve this error check out this blog on Resolving WhatsApp API Error 133006: "Phone Number Re-Verification Needed".

      Error Code 133008: Too Many two step verification PIN Guesses

      Error Message: Too many two-step verification PIN guesses for this phone number.

      Error 133008 occurs when too many incorrect attempts are made to input the two-step verification PIN for a phone number linked to the WhatsApp Business API. The lockout period is specified in the error's details response value. During this time do not attempt to input the PIN again. After the lockout period is over enter the correct PIN. If you have forgotten the PIN set a new one by logging in to WhatsApp Manager.

      For a detailed solution to resolve WhatsApp API Error 133008 check out this blog on Resolving WhatsApp API Error 133008: Too Many Two-Step Verification PIN Guesses.

      Error Code 133009: Two step verification PIN Guessed Too Fast

      Error Message: Two-step verification PIN was entered too quickly.

      Error 133009 occurs when the two-step verification PIN is entered too quickly. This error acts as a security measure to prevent automated or brute-force attempts to guess the two-step verification PIN. Rapid retries are flagged as suspicious behavior. Wait for the amount of time specified in the error's details response value. After the wait period, carefully re-enter the two-step verification PIN slowly.

      To read about WhatsApp API Error 133009 in detail check out this blog on Resolving WhatsApp API Error 133009: Two-Step Verification PIN Guessed Too Fast.

      Error Code 133010: Phone number Not Registered

      Error Message: Phone number not registered on the WhatsApp Business Platform.

      If you're encountering Error 133010 while using the WhatsApp Business API, it means the phone number you're attempting to use has not been registered on the platform. For a step by step guide to help you understand the issue and steps to resolve it check out this blog on Troubleshooting WhatsApp API Error 133010: Phone Number Not Registered.

      Error Code 133015: Please wait a few minutes before attempting to register this phone number

      Error Message: The phone number you are attempting to register was recently deleted, and deletion has not yet completed.

      Error 133015 occurs when you try to register a phone number that was recently deleted but has not yet completed the deletion process. The solution is simple. To resolve this error wait at least 5 minutes before reattempting to register the phone number. After waiting, retry the registration request.

      To read about this error in detail check out this blog on Resolving WhatsApp API Error 133015: Please Wait Before Registering.

      Error Code 135000: Generic User Error

      Error Message: Message failed to send because of an unknown error with your request parameters.

      While there is no clear solution to the generic user error, a simple hack often fixes it for most people: deleting all of the existing templates and creating new ones. If error persists try deleting the phone number and add it again. Detailed solution to Generic User Error has been discussed in the blog How to Fix the Generic User Error (135000) in WhatsApp Cloud API.

      ​