> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Fix WhatsApp error 131050: contact opted out of marketing

> WhatsApp error 131050 means the contact stopped marketing messages from your business. See why they are not on your Opt-outs list and how to stop sends.

**Error 131050** means the contact used WhatsApp to stop marketing messages from your business. WhatsApp won't deliver your Marketing templates to them. Other messages, such as Utility templates and replies, aren't affected by this choice.

> [!NOTE]
>
> Meta's wording: *Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business.* Meta says not to retry, because the messages won't be received. Contacts can resume marketing messages in WhatsApp later. Meta reports both changes through its [user\_preferences webhook](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/user_preferences), which Flowella doesn't use.

## How to confirm it in Flowella

* **Inbox.** The failed message has a red alert icon and the reason underneath: "This contact has opted out of marketing messages from your business. Do not retry marketing templates to them."
* **Send log.** For test sends and bulk sends, the template's **Send log** on the **Statistics** tab shows the same reason in **Details**.
* **HubSpot.** The failed step's **Error code** output is `FLOWELLA_META:marketing_opt_out`.

## Why the contact isn't on your Opt-outs list

This error comes from WhatsApp's own marketing opt-out, which is separate from the opt-outs Flowella records. Flowella doesn't add the contact to the **Opt-outs** page and doesn't stop later sends, so your workflows and bulk sends keep trying.

| Difference | WhatsApp's marketing opt-out | Flowella opt-out |
| - | - | - |
| How it starts | The contact stops marketing messages from your business in WhatsApp | The contact sends `STOP` or another opt-out keyword, or you add it with **Add opt-out**, **Import CSV** or the API |
| What it blocks | Marketing templates only | Every message from that WhatsApp number, including replies and Utility templates |
| Where you see it | Error 131050 on each marketing send | The **Opt-outs** page for that WhatsApp number |
| Who can change it | Only the contact, in WhatsApp | The contact, by sending `START` or `UNSTOP`, or your team with **Re-opt in** |

See [Opt-outs](https://knowledge.flowella.io/app/opt-outs.md) for how Flowella opt-outs work.

## How to stop marketing sends to the contact

**1. Don't resend the marketing template**

Every marketing template you send to this contact fails with 131050 until they resume marketing messages in WhatsApp.

**2. Keep them out of marketing sends in HubSpot**

Record the opt-out in HubSpot so your marketing workflows skip the contact. For example, add them to a suppression list, or set a contact property that your marketing workflows exclude. Flowella doesn't write this to HubSpot for you.

**3. Remove them from bulk send lists**

Take the contact's number out of the files you use for [bulk sends](https://knowledge.flowella.io/app/bulk-send.md) of marketing templates.

**4. Keep sending what they still need**

Replies and Utility templates about their orders, bookings or account still reach them. Don't send marketing content as a Utility template: Meta categorises templates by their content and can move them to Marketing. See [Template reference](https://knowledge.flowella.io/app/template-reference.md).

> [!WARNING]
>
> Use **Add opt-out** only if the contact wants no WhatsApp messages from you at all. A Flowella opt-out blocks every message from that WhatsApp number, including Inbox replies and Utility templates. See [Add an opt-out](https://knowledge.flowella.io/app/opt-outs.md#add-an-opt-out).

## Related codes

| Code | What it's about | Guide |
| - | - | - |
| **131049** | WhatsApp's limit on marketing messages to this contact. They haven't necessarily opted out. | [Error 131049](https://knowledge.flowella.io/whatsapp/limits/per-user-marketing-limit.md) |
| **131047** | The 24-hour window has closed | [Error 131047](https://knowledge.flowella.io/whatsapp/errors/error-131047.md) |

## Related

* [WhatsApp error codes](https://knowledge.flowella.io/whatsapp/errors/error-codes.md)
* [Opt-outs](https://knowledge.flowella.io/app/opt-outs.md)
* [Opt-out not honoured](https://knowledge.flowella.io/troubleshooting/opt-out-not-honoured.md)
* [HubSpot workflow actions](https://knowledge.flowella.io/hubspot/workflow-actions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.