> ## 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.

# Marketing Messages API for WhatsApp and Flowella

> Meta's Marketing Messages API for WhatsApp: what it adds, the 2027 end of marketing on the Cloud API, regional limits, and what it means for Flowella.

The **Marketing Messages API for WhatsApp** (MM API) is Meta's separate route for sending Marketing templates. It runs alongside the Cloud API on the same phone number, with the same templates and the same billing model, and adds delivery optimisation, extra formats and richer reporting. Meta is making it the only API route for marketing. The Cloud API stops supporting marketing messages on **13 October 2027**, and Messaging accounts created from **13 April 2027** can't send marketing through the Cloud API at all. Utility, authentication and service messages stay on the Cloud API.

> [!NOTE]
>
> **In Flowella.** Not available yet. Flowella sends every template, Marketing included, through the Cloud API. Meta's deadlines apply to every provider, Flowella included. Watch [Platform changes](https://knowledge.flowella.io/whatsapp/platform-changes.md) for updates. If another tool has moved your marketing to the MM API and Flowella's Marketing sends now fail, see [Error 131063](https://knowledge.flowella.io/whatsapp/errors/error-131063.md).

## Timeline

| Date | What happens |
| - | - |
| 19 November 2025 | The MM API became generally available. |
| 13 October 2026 | Meta announced the end of marketing messages on the Cloud API. |
| 13 April 2027 | Messaging accounts created on or after this date can only send marketing through the MM API. Older accounts can still use the Cloud API. |
| 13 October 2027 | Sending a marketing message on the Cloud API returns an error for every account. |

## What it adds

| Feature | MM API | Cloud API |
| - | - | - |
| Delivery optimisation | Yes. Meta factors in how engaging a message is, and reported up to 9% more deliveries in its own test. | No |
| Automatic image and text adjustments | Pilot | No |
| Animated GIF headers | Yes | No |
| Android app deep links | Yes | No |
| Message time-to-live | 12 hours to 30 days for Marketing | Utility and authentication only |
| Benchmarks and recommendations | Yes | No |
| Website and app conversion metrics | Yes. See [Conversion measurement](https://knowledge.flowella.io/whatsapp/measurement/conversion-measurement.md). | No |
| Sent, delivered, read, clicked and cost metrics | Yes | Yes |
| Media, carousel, catalogue, Flow, list and reply button formats | Yes | Yes |

## Where the extras don't apply

Some features depend on where the business number and the customer are.

| Region | What's different |
| - | - |
| European Economic Area, United Kingdom, Japan, South Korea, Nigeria, South Africa, Thailand | No delivery optimisation, and no click or conversion reporting. Metrics are available in WhatsApp Manager, as with the Cloud API. |
| United States | Meta doesn't deliver marketing messages to WhatsApp users in the US on any API. Businesses with US numbers can still message people elsewhere. |
| Russia, Belarus | Available, without delivery optimisation, click and conversion reporting or maximum pricing. |
| Sanctioned regions | Not available, as for the Cloud API. |

If you send from or to the UK or Europe, the change for you is mainly the route your marketing takes, not the features.

## How a business joins

A person with full control of the business portfolio accepts Meta's terms in WhatsApp Manager.

**1. Open WhatsApp Manager**

Go to [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/) and open **Overview**.

**2. Accept the terms**

In the **Alerts** section, select **Accept terms** for the Marketing Messages API for WhatsApp, then follow the steps.

Joining doesn't change your phone numbers or templates. When you join:

* Meta creates read-only ad accounts linked to your Marketing templates, so marketing results also appear in the **Marketing Messages** tab of Ads Manager.
* Meta starts sharing message events (delivered, read and clicked) for optimisation. You can turn this off in your [WhatsApp account settings](https://business.facebook.com/latest/settings/whatsapp_account).

Accepting the terms doesn't stop Flowella sending Marketing templates. Marketing sends from Flowella fail only if someone also sets `disable_marketing_messages_on_cloud_api` to `true`, which makes the Cloud API refuse Marketing templates with error `131063`.

## What to do now

| Your situation | What to do |
| - | - |
| You send marketing only from Flowella | Nothing today. Keep sending Marketing templates as normal. |
| Another tool asked you to join the MM API | Joining is fine. Ask that tool not to turn off marketing on the Cloud API while Flowella sends your marketing. |
| Flowella's Marketing sends fail with `131063` | See [Error 131063](https://knowledge.flowella.io/whatsapp/errors/error-131063.md). |
| You plan to connect a new WhatsApp Business Account to Flowella after 13 April 2027 | Contact [Flowella support](https://flowella.io/support) before you connect it, to check how Marketing templates will send. |

Don't change a Marketing template to Utility to avoid the MM API. Meta reviews categories and can restrict accounts that miscategorise templates. See [Template categories](https://knowledge.flowella.io/whatsapp/templates/template-categories.md).

## Related

> [card] [Marketing templates](https://knowledge.flowella.io/whatsapp/templates/marketing-templates.md)
>
> Formats, rules and per-user limits.

> [card] [Error 131063](https://knowledge.flowella.io/whatsapp/errors/error-131063.md)
>
> When the Cloud API refuses Marketing templates.

> [card] [Conversion measurement](https://knowledge.flowella.io/whatsapp/measurement/conversion-measurement.md)
>
> Clicks, conversions and Click to WhatsApp ad leads.

> [card] [Platform changes](https://knowledge.flowella.io/whatsapp/platform-changes.md)
>
> Every dated Meta change that affects you.

Checked against Meta's documentation on 18 November 2026: [Marketing Messages API overview](https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/overview), [Features](https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/features), [Get started](https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/get-started) and [Onboard](https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/onboarding).


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