Home/Glossary/WhatsApp error 131049: what it means and how to fix it

Error codes

WhatsApp error 131049: what it means and how to fix it

Error 131049 ("This message was not delivered to maintain healthy ecosystem engagement") is returned by the WhatsApp Cloud API when Meta declines to deliver a marketing template because the recipient has already received their allowed volume of marketing messages from businesses in the current period. The message is not delivered and not charged.

Updated 29 Aug 2026 · 1 min read

On this page
  1. Why it matters
  2. In VGraple CRM
  3. Related terms

ERROR CODES

Error 131049

Error 131049 ("This message was not delivered to maintain healthy ecosystem engagement") is returned by the WhatsApp Cloud API when Meta declines to deliver a marketing template because the recipient has already received their allowed volume of marketing messages from businesses in the current period. The message is not delivered and not charged.

frequency cappingheld messagemarketing templateerror 131049 frequency cap

Error 131049 in one line

Why it matters

131049 is the most misunderstood WhatsApp error. It says nothing about your number's quality; it is the per-user frequency cap acting on a recipient who gets a lot of marketing. Retrying immediately fails again, and since April 2026 Meta counts rapid retries against the sender. The correct response is to wait and retry once later, or to reach the person with a utility message about something they actually did.

In VGraple CRM

Recipients failing with 131049 are placed in a held state with the reason, retried once after a cooling period, and reported as capped rather than failed so the campaign numbers stay honest. The suppression rules also skip contacts who received marketing from you in the last days, which lowers how often you hit the cap at all. The 131049 guide has the full playbook.

Frequency Capping, Held Message, Marketing Template, help/error-131049-frequency-cap.

Frequently asked questions

Am I charged for a 131049 message?
No.
Is 131049 a problem with my quality rating?
No. It is a per-user cap that applies to every business.
When should I retry?
Once, after at least 24 hours; VGraple CRM does this automatically.

Run your WhatsApp on VGraple CRM

Free forever plan, official Meta WhatsApp Business API, set up in 15 minutes. No card needed.