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.

As of November 2026.

What changed

BeforeNow
Marketing templates through the Cloud APISupportedSupported until October 13, 2027. After that, Meta says sending them "will produce an error"
New Messaging accountsCould send marketing templates on the Cloud APIAccounts created on or after April 13, 2027 can't. They must use the Marketing Messages API
Service, utility and authentication messagesCloud APINo change. They stay on the Cloud API
A utility template Meta reclassifies as marketingCould still go out through the Cloud APIMust be routed to the Marketing Messages API
Price of a marketing messageThe published rate for the lead's countryMeta says the new API has "the same billing model." You can also set a max price (open beta since October 1, 2026)
Extra featuresBasic templates, sends, reads, clicks and costThe 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_amount per 1,000 deliveries inside optimization_spec, with bid_strategy set to LOWEST_COST_WITH_BID_CAP. A template without optimization_spec pays 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

  1. Find out how your marketing templates go out. Ask your provider or developer. In status webhooks, messages sent through the new API show marketing_lite as their category.
  2. Check eligibility. The marketing_messages_onboarding_status field on your WhatsApp Business account reads ELIGIBLE or, once done, ONBOARDED.
  3. 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.
  4. 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_api to true. 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.
  5. Decide on creative optimizations and data sharing before your first send. Opt out with creative_features_spec if your templates carry wording legal approved.
  6. 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.
  7. 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

DateWhat happens
April 1, 2025Meta stops delivering marketing messages to US numbers
November 19, 2025The Marketing Messages API reaches general availability
May 15, 2026Max price starts as a limited beta
October 1, 2026Max price open beta
October 13, 2026The global announcement, per Meta's overview
October 21, 2026Meta's developer blog post on the sunset
November 1, 2026Max price messages billed under their own billing SKU
April 13, 2027New Messaging accounts can't send marketing messages on the Cloud API
Q2 2027Max price general availability; required in eligible countries
October 13, 2027Cloud API support for marketing messages ends. After this, sending them returns an error
Sources (14)

Related resources