# WhatsApp Cloud API Error Codes Reference > Source: https://netray.co/tools/whatsapp-cloud-api-error-codes-reference > Publisher: Netray (netray.co), AI and integration engineering for ERP and manufacturing systems. > Section: Free Tools ## Short answer A searchable lookup of common WhatsApp Business Cloud API error codes, what they mean and the first thing to check. ## Category developer ## Audience - Integration developer - ERP administrator - IT support ## Tool **Kind:** worksheet **Mode:** reference **Columns:** #### Code **Key:** code **Type:** text #### Meaning **Key:** meaning **Type:** text #### Area **Key:** area **Type:** text #### First thing to check **Key:** first_check **Type:** text **Rows:** **Code:** 0 **Meaning:** AuthException: could not authenticate the app user **Area:** Auth **First check:** Regenerate the access token and confirm the app is still authorised **Code:** 3 **Meaning:** API method: capability or permissions issue **Area:** Auth **First check:** Check the app has whatsapp_business_messaging permission **Code:** 10 **Meaning:** Permission denied or removed **Area:** Auth **First check:** Check permissions granted to the system user token **Code:** 100 **Meaning:** Invalid parameter **Area:** Request **First check:** Compare the JSON body with the endpoint documentation **Code:** 190 **Meaning:** Access token expired or invalid **Area:** Auth **First check:** Replace short lived tokens with a system user token **Code:** 368 **Meaning:** Temporarily blocked for policy violations **Area:** Policy **First check:** Review the account quality and policy notices in Business Manager **Code:** 80007 **Meaning:** Rate limit issues at WhatsApp Business Account level **Area:** Throughput **First check:** Slow down and back off with jitter before retrying **Code:** 130429 **Meaning:** Cloud API throughput rate limit reached **Area:** Throughput **First check:** Queue sends and retry with exponential backoff **Code:** 130472 **Meaning:** User number is part of an experiment **Area:** Delivery **First check:** No action usually possible; retry later or use another channel **Code:** 131000 **Meaning:** Something went wrong **Area:** Server **First check:** Retry once, then raise with Meta support if it persists **Code:** 131005 **Meaning:** Access denied **Area:** Auth **First check:** Confirm the token owner is assigned to the WhatsApp Business Account **Code:** 131008 **Meaning:** Required parameter is missing **Area:** Request **First check:** Check the error details field for the missing parameter name **Code:** 131009 **Meaning:** Parameter value is not valid **Area:** Request **First check:** Check phone number format (digits with country code) and field types **Code:** 131016 **Meaning:** Service unavailable **Area:** Server **First check:** Check the Meta status page and retry later **Code:** 131021 **Meaning:** Recipient cannot be sender **Area:** Request **First check:** Do not send to the business phone number itself **Code:** 131026 **Meaning:** Message undeliverable **Area:** Delivery **First check:** Recipient may not be on WhatsApp, may have an old app version or has not accepted the terms **Code:** 131030 **Meaning:** Recipient phone number not in allowed list **Area:** Setup **First check:** Add the number to the test recipient list or move the app to live mode **Code:** 131031 **Meaning:** Account has been locked **Area:** Policy **First check:** Check for a verification or policy lock in Business Manager **Code:** 131042 **Meaning:** Business eligibility payment issue **Area:** Billing **First check:** Check the payment method and credit line on the account **Code:** 131045 **Meaning:** Incorrect certificate **Area:** Setup **First check:** Check phone number registration state and certificate **Code:** 131047 **Meaning:** Re-engagement message: more than 24 hours since the customer last replied **Area:** Window **First check:** Send an approved template message instead of a free form message **Code:** 131048 **Meaning:** Spam rate limit hit **Area:** Quality **First check:** Reduce unwanted messages; review block and report rates **Code:** 131049 **Meaning:** Message not delivered to maintain healthy ecosystem engagement **Area:** Quality **First check:** Check opt-in quality and message relevance for marketing sends **Code:** 131051 **Meaning:** Unsupported message type **Area:** Request **First check:** Check the type field against supported message types **Code:** 131052 **Meaning:** Media download error **Area:** Media **First check:** Check the inbound media ID and download it promptly with the token **Code:** 131053 **Meaning:** Media upload error **Area:** Media **First check:** Check the file type, size limit and MIME type **Code:** 131056 **Meaning:** Pair rate limit hit: too many messages to the same user in a short time **Area:** Throughput **First check:** Space out messages to one recipient and retry later **Code:** 131057 **Meaning:** Account in maintenance mode **Area:** Server **First check:** Retry after a short wait **Code:** 132000 **Meaning:** Template parameter count does not match **Area:** Template **First check:** Count the {{n}} variables in the approved template and match them **Code:** 132001 **Meaning:** Template does not exist in the language and locale **Area:** Template **First check:** Check the template name and the exact language code **Code:** 132005 **Meaning:** Translated text too long **Area:** Template **First check:** Shorten the variable values or the translation **Code:** 132007 **Meaning:** Template format character policy violated **Area:** Template **First check:** Review the template content against the messaging policy **Code:** 132012 **Meaning:** Template parameter format mismatch **Area:** Template **First check:** Check the parameter type (text, currency, date_time, media) against the template **Code:** 132015 **Meaning:** Template is paused **Area:** Template **First check:** Review quality rating and edit or replace the template **Code:** 132016 **Meaning:** Template is disabled **Area:** Template **First check:** Create a new template; disabled templates cannot be sent **Code:** 133000 **Meaning:** Previous deregistration attempt failed **Area:** Setup **First check:** Retry the deregister call before registering again **Code:** 133004 **Meaning:** Server temporarily unavailable **Area:** Server **First check:** Retry later **Code:** 133005 **Meaning:** Two step verification PIN mismatch **Area:** Setup **First check:** Check the six digit PIN used at registration **Code:** 133006 **Meaning:** Phone number needs to be verified before registering **Area:** Setup **First check:** Request and submit a verification code first **Code:** 133010 **Meaning:** Phone number not registered on the WhatsApp Business Platform **Area:** Setup **First check:** Call the register endpoint for the phone number ID **Notes:** Codes and wording are summarised from Meta public documentation and can change. Always read the full error object (code, subcode, message, error_data.details) in the actual response, and confirm against the current Meta error code page. ## Content **Intro:** When a WhatsApp Cloud API send fails, the response carries a numeric code that tells you whether to fix your request, wait, or change how you message. This table lets you look up the common codes and get the first thing to check. **Sections:** #### How to use this reference **Body:** Search by code or by a word from the message text. Log the full error object on every failed send, not just the HTTP status, because several different problems share a 400 response. Use the Area column to decide who owns the fix: request errors are for the developer, setup and billing errors are for the account owner, and quality or policy errors are for whoever runs the messaging programme. **Bullets:** - Request and Template errors are deterministic: fix the payload, do not retry blindly. - Throughput and Server errors are transient: retry with exponential backoff and jitter. - Window errors mean you must use an approved template, not free form text. - Quality and Policy errors need a human review of opt-in and content. #### Why the error classes matter for retry logic **Body:** A retry loop that treats every failure the same either hammers a rate limit or retries a permanent error forever. Classify the code first. A 132001 will fail on every retry until the template name or language is corrected. A 130429 will usually succeed once load drops. A 131047 should switch the send path from a session message to a template message and, if your design allows, create a record that the customer window has closed. #### Example: ERP shipment notification fails **Body:** An ERP posts a shipment confirmation to a customer, and the call returns 131047. The customer last wrote three days ago, so the 24 hour customer service window is closed. The fix is to send a utility template such as a shipment update with the order number and tracking link as variables. If it returns 132000 instead, the template has two variables and the code sent three, so check the mapping between ERP fields and template parameters. #### Common mistakes **Body:** Teams often log only the message string, which is vague, and lose the numeric code that identifies the problem. Others hardcode a language such as en when the template was approved as en_US. Another frequent error is using a short lived token from the developer console in production, which then fails with 190 on a weekend. **Cta:** If you want failed messaging calls from your ERP triaged and retried by class automatically, Netray can build that into your integration layer. **Faq:** #### What does WhatsApp error 131047 mean? **Answer:** It means you tried to send a free form message to a customer who has not messaged you in the last 24 hours. Outside that window only approved template messages are allowed, so resend using a template that fits the purpose. #### How do I fix error 132000 on a template? **Answer:** The number of parameters in your request does not match the variables in the approved template. Count the numbered placeholders in the template body, header and buttons, then send exactly that many components in the right order. #### Is error 130429 a permanent failure? **Answer:** No. It signals that you reached the Cloud API throughput limit for your number. Queue outgoing messages, retry with exponential backoff and jitter, and smooth bulk sends so they do not arrive in one burst. #### Are these codes the complete list? **Answer:** No. This is a working subset of frequently seen codes. Meta adds and changes codes over time, so treat the live documentation and the error details in your own responses as the authority. ## Search terms whatsapp cloud api error codes, whatsapp error 131047, whatsapp error 131026, whatsapp template error 132000, whatsapp business api error list, whatsapp 130429 rate limit, whatsapp api error codes list --- Talk to an engineer: https://netray.co/contact?intent=erp_ai | Machine catalog: https://netray.co/agent/catalog.json