WhatsApp error 131049: Meta chose not to deliver.
Last verified against Meta for Developers - Cloud API error codes
This message was not delivered to maintain healthy ecosystem engagement.What error 131049 means
Code 131049 means Meta decided not to deliver a marketing template to this recipient in order to protect the recipient's experience. It is the visible side of the per-user marketing template message limits: WhatsApp caps how many marketing messages a single user receives from all businesses within a period, and it also factors in how little that user engages with marketing. When the recipient is at their limit, your marketing template is dropped with 131049, and you are not charged.
This is per recipient and per period, not a judgment on your account. Your other recipients are unaffected, and the same person will become reachable again when their limit resets. Meta's guidance is to wait at least 24 hours before trying again and to avoid immediate retries, which will only produce the same response while the limit is in effect.
Utility and authentication templates, and service messages inside the 24-hour window, are not subject to this limit.
131049 arrives almost exclusively in the statuses webhook, because the drop happens at delivery time: the synchronous response is a normal 200 with a message ID, and the failure follows moments later. That makes webhook handling mandatory for honest campaign reporting - if events are missing, work through the webhook debugging guide. Two distinctions keep triage straight: unlike 131050 it is not a choice the user made, so it needs no suppression-list entry, and unlike 131048 it says nothing about your number's quality. Providers built on the Cloud API relay the code in their delivery callbacks rather than the send response, so with a BSP look in the failure payload. Since the message is not delivered, it is not billed.
What it looks like
{
"statuses": [{
"id": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgSRjU4Q0Q5RDQ2RjhGNjcyNEEwAA==",
"status": "failed",
"timestamp": "1755584400",
"recipient_id": "919876543210",
"errors": [{
"code": 131049,
"title": "This message was not delivered to maintain healthy ecosystem engagement.",
"message": "This message was not delivered to maintain healthy ecosystem engagement.",
"error_data": { "details": "Marketing message limit for this user reached." }
}]
}]
}Why it happens
- The recipient has already received the maximum number of marketing messages allowed in the current period.
- The recipient rarely engages with marketing, which lowers their allowance.
- Your campaign is re-sending to the same audience more often than the per-user limits allow.
- Transactional content was categorized as marketing and is being suppressed as a result.
How to fix WhatsApp error 131049
- 1Do not retry immediately; schedule any retry for at least 24 hours later, and stop after a couple of attempts.
- 2Record the outcome against the contact so reporting distinguishes it from a failed delivery.
- 3Reduce frequency to the same users and prioritize recently engaged contacts.
- 4Move genuinely transactional content into utility templates, which are not limited this way.
- 5Read Meta's per-user marketing template message limits documentation for the current behaviour.
How to stop it recurring
Build frequency capping and engagement scoring into your marketing dispatch so you send fewer messages to people who are least likely to want them; those are exactly the sends Meta will drop. Keep transactional and marketing content strictly separated by template category, and treat a rising 131049 rate as a signal to tighten segmentation rather than to add retries. Per-user marketing limits sit alongside the per-number messaging tiers; both cap marketing reach, but this one belongs to the recipient, not to you.
Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.
Related codes
- 131050: User has stopped reciept of marketing messages.Unable to deliver the message. This recipient has chosen to stop receiving…
- 131048: Spam rate limit hitMessage failed to send because there are restrictions on how many messages can…
- 130472: User's number is part of an experimentMessage was not sent as part of an experiment.
- 131026: Message UndeliverableUnable to deliver message. Reasons can include: The recipient phone number is…
Error 131049 - quick answers
What does WhatsApp error 131049 mean?
Code 131049 means Meta decided not to deliver a marketing template to this recipient in order to protect the recipient's experience. It is the visible side of the per-user marketing template message limits: WhatsApp caps how many marketing messages a single user receives from all businesses within a period, and it also factors in how little that user engages with marketing.
How do I fix WhatsApp error 131049?
1. Do not retry immediately; schedule any retry for at least 24 hours later, and stop after a couple of attempts. 2. Record the outcome against the contact so reporting distinguishes it from a failed delivery. 3. Reduce frequency to the same users and prioritize recently engaged contacts. 4. Move genuinely transactional content into utility templates, which are not limited this way. 5. Read Meta's per-user marketing template message limits documentation for the current…
Stop debugging WhatsApp by hand
Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.