Key takeaways

  • 131047 means the 24-hour window has closed: send an approved template instead of a free-form message.
  • 131049 and 130472 are Meta holding back marketing messages. Wait at least 24 hours on 131049; 130472 has no opt-out.
  • 132000, 132001 and 132012 mean the send doesn't match the approved template's name, language or variables.
  • 368 and 131031 can mean the account is restricted for a policy violation; read the details before you appeal.

Which errors mean the message didn't reach the customer?

Seven codes here mean the message didn't arrive: a closed window, a recipient who can't receive it, a held-back marketing message, an unsupported message type or file, or an unknown error. Three of them, 131047, 131049 and 130472, are WhatsApp's rules on when a business may write, not faults in your code.

CodeWhat it means for your businessFirst fix
131047More than 24 hours have passed since the customer last wrote, so the customer service window is closed.Send an approved template instead.
131026WhatsApp couldn't deliver: the number may not be on WhatsApp, or the customer hasn't accepted the latest terms or uses an old app version.Ask the customer by SMS, call or email to message you on WhatsApp, accept the terms or update the app.
131049Meta didn't deliver a marketing template, for example because the customer reached their per-user limit for marketing messages.Wait at least 24 hours before resending. Earlier retries return the same error.
130472The customer is in a Meta experiment group that gets no marketing templates from any business. The message isn't sent or billed.Nothing to fix, and there's no opt-out. It goes through when the customer has an open customer service window.
131051The message type isn't supported.Check the message types Meta supports, then resend.
131053The media file couldn't be uploaded, for example because its file type isn't supported.Check the file against Meta's supported media types; the error details in the webhook say more.
131000The message failed for an unknown reason.Try again. If it keeps happening, open a Direct Support ticket with Meta.

Which errors come from the template or the request?

Six codes mean the send request doesn't match an approved template, or the template itself was paused for low quality. The fix sits in the template's name, language, variables or content, not in the customer's number.

CodeWhat it means for your businessFirst fix
132000The number of variable values sent doesn't match the number of variables in the template.Send a value for every variable the template defines.
132001The template doesn't exist in that language, or isn't approved yet.Check it's approved, and that the name and language code match exactly.
132012Variable values aren't in the format the template expects.Send each value in the format set in the template.
132015The template is paused because of low quality.Edit the template to improve it, and send again once it's approved.
132016The template was paused too many times and is now permanently disabled.Create a new template with different content.
131009One or more values in the request aren't valid.Check Meta's reference for that endpoint to see which values it accepts.

Meta rates every template on usage, customer feedback and engagement, and pauses a template at the lowest rating for a period of time. Attempts to send a paused template aren't charged.

Writing templates Meta approves

Which errors mean the account or number is restricted?

368 and 131031 mean Meta has restricted or disabled the WhatsApp Business account for a policy violation. 131031 can also mean data in the request didn't match the account, such as a wrong two-step PIN. 133010 means the number isn't registered on the platform yet.

CodeWhat it means for your businessFirst fix
368The account is restricted or disabled for breaking a platform policy.Read the violation in Business Support Home, and appeal within 90 days if you disagree.
131031The account is locked for a policy violation, or data in the request didn't match the account, such as the two-step PIN.Check the PIN first. For a violation, read Meta's policy enforcement page; the Health Status API can show the reason.
133010The phone number isn't registered on the WhatsApp Business Platform.Register the number, then send again.

Meta's penalties range from a 1 or 3 day block on marketing, utility and authentication templates to a 5, 7 or 30 day block on all messages. Plan how you'll reach customers on other channels meanwhile.

If the number is banned

Before the next campaign, see where messages and customers get lost

The Leak Audit is free, with no obligation. Within 72 hours of the discovery meeting and receipt of the agreed information, we map your current journey, show the gaps the evidence supports, prioritise next steps and demonstrate one agreed workflow in a test environment. You keep the report. If you don't need HumAI, the audit says so.

What does error 131042 mean for billing?

131042 means Meta found a problem with the payment method on your WhatsApp Business account. Fix it in the billing settings of the account that pays Meta, whether you pay Meta directly or through your provider.

Without a payment method, Meta still delivers service messages within the monthly free tier of 1,000 per business number, but not after it's used up.

What do rate limit errors 130429, 131056 and 131048 mean?

They mean you're sending too fast or too much. 130429 is your number's overall throughput, 131056 is too many messages to the same customer in a short time, and 131048 is a restriction tied to your number's quality. Slow down first, then check the quality rating in WhatsApp Manager.

CodeWhat it means for your businessFirst fix
130429Your number reached its Cloud API throughput.Try again later, or spread the campaign over a longer time.
131056Too many messages from your number to the same customer in a short time.Wait before you message that customer again.
131048Sending from this number is restricted.Check the quality rating in WhatsApp Manager.

Where does HumAI fit, and when don't you need us?

HumAI is a Meta Tech Provider. We set up your number on the official WhatsApp Business Platform, prepare your templates in Arabic and English for Meta's approval, and send campaigns only to customers who opted in. When a send fails, we read the code with you, fix what sits with us, such as a template, and tell you what needs you, such as billing. You pay Meta directly or through our invoice. We run the WhatsApp side for you, and you approve every campaign.

Picture a clothing store in Dubai sending its Eid campaign. The first run returns 132001 because the Arabic version of the template was still waiting for approval, plus a batch of 131049 from customers who had reached Meta's marketing limit. The fix is to wait for the Arabic approval, send to the rest, and leave the held-back customers for at least 24 hours instead of retrying.

We build only on the official WhatsApp Business Platform, not unofficial apps or WhatsApp Web automation, so your number isn’t exposed to the bans those tools cause.

Meta's policies still apply to every business number, and no provider can promise that a number won't be banned.

You don't need us if your developer already reads the webhooks, fixes templates in-house and keeps sends within Meta's limits.

Related

Questions owners ask

Where do WhatsApp API error codes show up?

In two places. Meta returns Cloud API errors either straight away in the API response, later in a webhook, or sometimes both. A message that was accepted can still fail afterwards, so your developer should log webhook statuses as well as responses.

Am I charged for messages that fail?

Meta's pricing page says businesses are only charged when a message is delivered. Meta also says it doesn't bill messages held back by its marketing experiment (130472), and attempts to send a paused template aren't charged.

Should failed messages be retried automatically?

Only for some codes. Meta says to try again on 131000 and to slow down on 130429. Don't retry 131049 within 24 hours, because earlier retries return the same error. Retry 130472 only after the customer writes to you, because it goes through inside an open window. For 131047, send a template instead.

Does error 131026 mean the customer blocked us?

Meta's error page doesn't list blocking as a reason for 131026. The reasons it lists are a number that isn't on WhatsApp, a customer who hasn't accepted the latest terms, and an old app version. Check the number first, then contact the customer through another channel.

Is error 368 the same as a banned number?

Not always. Meta says 368 means the WhatsApp Business account has been restricted or disabled for a policy violation. A restriction is a block of 1 to 30 days on templates or on all messages. Every policy violation can be appealed within 90 days, and Business Support Home shows which one you have.

Sources

  1. Meta for Developers: WhatsApp Cloud API error codes
  2. Meta for Developers: Per-user marketing template message limits
  3. Meta for Developers: Experiments
  4. Meta for Developers: Policy enforcement
  5. Meta for Developers: Template pausing
  6. Meta for Developers: Messaging limits
  7. Meta for Developers: Pricing on the WhatsApp Business Platform and rate cards
  8. Meta Business Help Center: View policy violation details for your WhatsApp Business account

Read next

Start with where you lose customers.

See where your business loses customers on WhatsApp, and what to fix first.