Message Failed to Send

What is this?

When a WhatsApp message can’t be delivered, it stays in the conversation with a red Failed mark. The reason is always shown — you just have to open it.

What can I do here?

Find the exact reason for a failed message
Match it to the most common causes and fixes
Know which failures are worth retrying

How to use it

Find the reason

In the Inbox: click the red Failed mark next to the message time. You’ll see the Error Code and Reason.
In a campaign: open the campaign’s results — failed recipients list the reason.
In an automation: open its Automation Report and the failing step.
From the API or your webhook: the response, or the message.status update with status.value failed, carries the code and message. See API and webhook problems.

Then look up the code in the Error code reference or the table below.

The most common reasons

What you see	What it means	What to do
Invalid country code	The phone has no country code	Fix the number
`131047` — more than 24 hours since the customer last replied	You can only send free-form messages within 24 hours of the customer’s last message	Send an approved template instead, or wait for the customer to message you
`132001` / `132000` / `132012`	The template isn’t approved, is in another language, or the variables don’t match	Template problems
`131026` — undeliverable	The number isn’t on WhatsApp, the customer hasn’t accepted WhatsApp’s terms, or their app is very old	Check the number; nothing else can be done — it won’t succeed on retry
`131050` — recipient opted out of marketing	The customer stopped marketing messages from you	Don’t send marketing to them. Utility messages may still go through
`131049` — not delivered to keep engagement healthy	WhatsApp limits how many marketing messages one person receives	Wait; don’t retry straight away. Send more relevant, less frequent messages
`130403` — the business has blocked this recipient	You blocked this contact	Unblock the contact
`131021` — sender and recipient are the same	You messaged your own number	Use the customer’s number
`131042` — payment method problem	No working payment method, or billing isn’t set up (Direct numbers)	Add a payment method in Meta billing — Number and account problems
`WALLET_EXHAUSTED` — wallet balance is insufficient	A credit line number has no wallet balance. The send never reached WhatsApp	Recharge your wallet — Transactions
`CREDIT_LINE_NOT_ATTACHED`	A credit line number’s credit line isn’t attached yet	Channels → WhatsApp → Retry — WhatsApp channel
`130429`, `131056`, `131048`, `80007`, `4` — limits	Too many messages too fast, or too many to the same person	Wait and retry; slow your sends down
`190`, `0`, `10`, `200`–`299`	The access token expired or a permission is missing	Settings on the card to paste a new token, or Reconnect

Which failures to retry

Temporary (limits, maintenance, “try again”): safe to retry after a few minutes. Campaigns retry many of these automatically.
Permanent (invalid number, not approved, opted out, restricted): retrying won’t help — fix the cause first.

Each code in the Error code reference says which kind it is.

Troubleshooting / Technical Notes

Only some messages in a campaign failed. Look at each failure reason — a few bad numbers, opt-outs or the per-person marketing limit are normal. The rest are unaffected.
Every message fails with the same code. The cause is on the number or account (token, payment, restriction, template) — check WhatsApp Health.
It says sent, but the customer never got it. Look at the delivery status: sent, delivered, read. A message that stays at sent may be waiting on the customer’s phone being online.
The customer replied, but I still can’t send a normal message. The 24-hour window starts again at their latest reply. Check the time in the conversation.

​What is this?

​What can I do here?

​How to use it

​Find the reason

​The most common reasons

​Which failures to retry

​Troubleshooting / Technical Notes

​Related docs