WhatsApp is ending marketing messages on the Cloud API. What do businesses that follow up ad leads on WhatsApp need to change?
TofuAnswer by the Tofu team · checked
You need to change something only if you send WhatsApp marketing templates through the Cloud API to leads outside the US. In October 2026, Meta announced that Cloud API marketing messages end on October 13, 2027. They move to the Marketing Messages API for WhatsApp, on the same number and templates. Accounts created from April 13, 2027 can't send them on the Cloud API at all. Your replies to leads, and utility and authentication templates, stay on the Cloud API. Meta already delivers no marketing templates to US numbers.
Ask Tofu next
Pick a question and Tofu Ads Agent answers it in chat.
- Do WhatsApp marketing messages reach leads in the UK and EU, and what can't I measure there?
- Write a WhatsApp utility template for demo confirmations that Meta won't reclassify as marketing
- Which countries should my B2B click-to-WhatsApp ads target if my team follows up with marketing templates?
- How do I get leads from my click-to-WhatsApp ads into HubSpot or Salesforce?
- Should I set a max price on WhatsApp marketing templates for a small B2B lead list?
As of November 2026.
What changed
| Before | Now | |
|---|---|---|
| Marketing templates through the Cloud API | Supported | Supported until October 13, 2027. After that, Meta says sending them "will produce an error" |
| New Messaging accounts | Could send marketing templates on the Cloud API | Accounts created on or after April 13, 2027 can't. They must use the Marketing Messages API |
| Service, utility and authentication messages | Cloud API | No change. They stay on the Cloud API |
| A utility template Meta reclassifies as marketing | Could still go out through the Cloud API | Must be routed to the Marketing Messages API |
| Price of a marketing message | The published rate for the lead's country | Meta says the new API has "the same billing model." You can also set a max price (open beta since October 1, 2026) |
| Extra features | Basic templates, sends, reads, clicks and cost | The new API adds delivery optimization, message expiry from 12 hours to 30 days, GIF headers, benchmarks against similar businesses, and conversion reporting |
Meta's overview lists October 13, 2026 as the date of the "global announcement." Its developer blog post is dated October 21, 2026. Meta doesn't explain the gap.
What is the Marketing Messages API, and do you have to move to it?
Yes, if you send marketing templates through the API. It's a second way to send from the same WhatsApp number. Meta says it "allows you to send marketing template messages only." The Cloud API keeps doing everything else on that number, including receiving messages and sending your replies. You keep your phone number and templates, and an already registered number needs no new verification. Meta says most integrations take about two weeks.
If you send through a WhatsApp provider, Meta has a separate guide for providers onboarding their business customers. For a business whose provider uses the Cloud API, that guide recommends onboarding directly in WhatsApp Manager, where someone with full control of your business portfolio accepts the terms (see step 3 below).
Check two things before your first send:
- Meta may change your message's look. Meta's "automatic creative optimizations" can filter header images, pull a headline or a title for the tap area out of your text, and change text formatting (Meta says formatting changes don't change the words). Meta's docs disagree on the default. The template setting says "All optimization features are enabled by default." The account setting says they "are disabled by default." You can opt out per template or for the whole account.
- Meta gets your engagement data. Once you're onboarded, delivery, read and click events "will automatically be shared with Meta." Meta says it uses them only to optimize marketing campaigns. You can turn this off in your WhatsApp Business account settings or per message.
How does max price bidding work?
You set the most you'll pay for each delivered marketing message. Meta charges that amount or less. It's a bid cap, not a budget.
- In WhatsApp Manager: go to Templates > Manage templates, create or edit a template, choose the Marketing category, then Edit template. In the Pricing section, pick Set maximum price (entered per 1,000 deliveries, with an Estimated results panel for cost and delivery) or Use default price (the published rate for each lead's country).
- In the API: set
bid_amountper 1,000 deliveries insideoptimization_spec, withbid_strategyset toLOWEST_COST_WITH_BID_CAP. A template withoutoptimization_specpays the published rate. - What the price does: Meta says a max price below the published rate reaches more people at lower cost, and one above it can "increase delivery rates" at busy times. So your price affects how many leads get the message.
- How Meta suggests testing it: four groups of 10,000 send requests each: no max price, and a max price at 0.9, 1 and 1.5 times the published rate (1.2 times for India and Saudi Arabia). Many B2B lead lists are smaller than that.
- Where it works: only for businesses in eligible countries. A max price template sent to a lead in an unsupported country fails with error 131065.
- What's next: since November 1, 2026, max price messages are billed under their own billing SKU. At general availability, planned for Q2 2027, Meta says max price "will become required in eligible geographies" and fixed published rates "will only apply on the Cloud API."
Who it affects
- Teams that follow up ad leads with marketing templates through the API, directly or through a provider. A typical case is a promotional nudge to book a demo after the 24-hour reply window has closed.
- Only leads outside the US. Since April 1, 2025, Meta has not delivered marketing messages to WhatsApp users with US phone numbers, on either API (error 131049). A US business number can still send them to leads in other countries. If all your leads are in the US, there is little to move. A utility template that Meta reclassifies as marketing becomes a marketing message, so it stops reaching US leads too.
- Leads in the EEA, the UK, Japan, South Korea, Nigeria, South Africa and Thailand. Messages to or from these countries get no delivery optimization and no click or conversion reporting. Meta notes its per-user marketing limits aren't active there either.
Who can mostly ignore it:
- Teams that only reply to leads. Free-form replies are service messages and stay on the Cloud API. What those replies cost, and the free window after a click-to-WhatsApp ad, are covered in Do I pay to reply to leads from my click-to-WhatsApp ads? Meta's pricing page covers both APIs and doesn't say that window works differently on either.
- Teams that let Meta Business Agent answer. Its replies are billed as their own category; see what Meta Business Agent costs per token.
- WhatsApp Business app users. Meta's notice is about the Cloud API and doesn't mention the app.
What to do now
- Find out how your marketing templates go out. Ask your provider or developer. In status webhooks, messages sent through the new API show
marketing_liteas their category. - Check eligibility. The
marketing_messages_onboarding_statusfield on your WhatsApp Business account readsELIGIBLEor, once done,ONBOARDED. - Accept the terms. Someone with full control of your business portfolio opens WhatsApp Manager > Overview, and in Alerts clicks Accept terms. Without a provider, use App Dashboard > WhatsApp > Quickstart, find the Marketing Messages API card, click Get started, then Continue to integration guide.
- Route every template by its latest category. Keep a map of each template's category and subscribe to the template category update webhook. Once onboarded, set
disable_marketing_messages_on_cloud_apitotrue. Then the Cloud API rejects a marketing template (error 131063) and you resend it through the new API, so nothing goes out the old way by mistake. - Decide on creative optimizations and data sharing before your first send. Opt out with
creative_features_specif your templates carry wording legal approved. - Set up conversion measurement. It uses the Meta Pixel or the Conversions API for App Events, owned by the same business as your WhatsApp account. "Leads (Web)" is one of the events Meta reports. Wait 10 minutes after creating a template before sending, while Meta syncs it.
- Leave max price for later unless your volumes can support Meta's test. Until general availability, a template without one pays the published rate.
Dates to watch
| Date | What happens |
|---|---|
| April 1, 2025 | Meta stops delivering marketing messages to US numbers |
| November 19, 2025 | The Marketing Messages API reaches general availability |
| May 15, 2026 | Max price starts as a limited beta |
| October 1, 2026 | Max price open beta |
| October 13, 2026 | The global announcement, per Meta's overview |
| October 21, 2026 | Meta's developer blog post on the sunset |
| November 1, 2026 | Max price messages billed under their own billing SKU |
| April 13, 2027 | New Messaging accounts can't send marketing messages on the Cloud API |
| Q2 2027 | Max price general availability; required in eligible countries |
| October 13, 2027 | Cloud API support for marketing messages ends. After this, sending them returns an error |
Sources (14)
- Sunsetting Marketing Messages on the Cloud API: Upgrade to the Marketing Messages API for WhatsApp before October 2027 (Meta for Developers blog, October 21, 2026), checked November 7, 2026
- Marketing Messages API for WhatsApp (Meta for Developers), checked November 7, 2026
- Get started with the Marketing Messages API (Meta for Developers), checked November 7, 2026
- Features (Meta for Developers), checked November 7, 2026
- Onboard (Meta for Developers), checked November 7, 2026
- Onboard business customers (Meta for Developers), checked November 7, 2026
- Send Marketing Messages (Meta for Developers), checked November 7, 2026
- Route template messages by category (Meta for Developers), checked November 7, 2026
- Set a max price for marketing messages (BETA) (Meta for Developers), checked November 7, 2026
- WhatsApp Manager experience (Meta for Developers), checked November 7, 2026
- Viewing metrics (Meta for Developers), checked November 7, 2026
- Marketing Messages API changelog (Meta for Developers), checked November 7, 2026
- Per-user marketing template message limits (Meta for Developers), checked November 7, 2026
- Pricing on the WhatsApp Business Platform (Meta for Developers), checked November 7, 2026