WhatsApp API / Cloud API migration guide

Cloud API marketing messages end in 2027: the migration dates and checks

Meta announced that WhatsApp marketing messages sent through the Cloud API will stop on 13 October 2027. There is an earlier boundary: Messaging accounts created on or after 13 April 2027 cannot use Cloud API for marketing sends. Marketing Messages API for WhatsApp is the successor send path. Service, Utility and Authentication messaging remains on Cloud API.

Published
Reading time
8 min
Attribution
Pending
Green illustration of a business phone routing messages toward Cloud API and a dedicated marketing send path
Illustration: plan a separate route for marketing templates while other message categories remain on Cloud API.

Part 01

Read the announcement and effective dates separately

Meta's developer blog published this migration notice on 21 October 2026. Its overview records a global sunset announcement on 13 October 2026, and says the Marketing Messages API became generally available on 19 November 2025. Those are announcement and product-availability milestones; the sending restrictions arrive later. This article was checked on 22 October 2026, so the 2027 dates below are scheduled future changes, not restrictions already observed in a customer account.

From 13 April 2027, a newly created Messaging account cannot send marketing messages through Cloud API. An account created before that date can continue using the Cloud API marketing path until 13 October 2027. From 13 October 2027, Meta says a Cloud API marketing send will return an error. Marketing sends can continue through Marketing Messages API, or other supported surfaces where Meta allows them.

Meta's published migration timeline

Scroll sideways to see every column →

Meta's published migration timeline
DateMeta milestonePlanning meaning
19 Nov 2025Marketing Messages API generally availableThe successor API is available for integration
13 Oct 2026Global sunset announcement recorded in Meta's overviewStart assessing existing marketing send paths
13 Apr 2027New Messaging accounts lose Cloud API marketing sendsOnboard new accounts directly to the Marketing Messages API
13 Oct 2027Cloud API marketing support ends globallyMove remaining marketing sends before this date

Part 02

Only the marketing send path changes

The sunset concerns WhatsApp marketing messages sent through the Cloud API. Meta explicitly says Service, Authentication and Utility messages remain supported there. Do not move all outbound traffic to the marketing endpoint: Meta's category-routing guide sends MARKETING templates to /<PHONE_NUMBER_ID>/marketing_messages and other supported categories to /<PHONE_NUMBER_ID>/messages.

Existing phone numbers and approved marketing templates can be used with the Marketing Messages API, according to Meta. Its overview describes a similar technical schema and the same billing model as Cloud API, but this does not prove that a provider's product surface, fees, permissions or account onboarding are already ready. Review the current Meta pricing and the customer's actual billing evidence before estimating a campaign cost.

Where each supported message category belongs after migration

Scroll sideways to see every column →

Where each supported message category belongs after migration
Message categoryDocumented API send path2027 change
Marketing templateMarketing Messages API /marketing_messagesRequired for new accounts from 13 Apr and all accounts from 13 Oct
Utility templateCloud API /messagesContinues on Cloud API
Authentication templateCloud API /messagesContinues on Cloud API
Service replyCloud API /messagesContinues on Cloud API under its existing rules

Part 03

Route by the latest template category

A template approved as Utility can later be reclassified as Marketing if its content is promotional. Meta specifically calls out that reclassified traffic must be routed to the Marketing Messages API. A sender that chooses the endpoint solely from an old template label can therefore break even when its marketing campaign list looks complete.

Meta's routing guidance recommends maintaining a mapping of Messaging account, template identity, language and latest category, subscribing to category-update webhooks, and refreshing missing or changed categories before sending. A controlled failed send may justify a category refresh and idempotent retry on the correct endpoint. An unknown delivery outcome does not justify a blind duplicate send.

Part 04

Run a small migration before moving campaigns

Start with an inventory of the business portfolios, Messaging accounts, phone numbers and marketing templates that actually send through Cloud API. Separate established accounts from any account planned for creation after 13 April 2027. Identify the owner of the sending integration and the person who can accept Meta's Marketing Messages API terms for the right business.

Marketing send migration

Inventory, pilot, then move campaigns

Keep the two 2027 dates, template category and observed delivery outcome visible in one plan.

Green three-stage illustration of Cloud API messaging, a dated review checklist and a marketing message send path
Illustration: inventory, test and reconcile a marketing send before changing the default route.

Inventory

Locate each account and marketing sender that still uses Cloud API.

Route

Use Meta's latest template category to choose the send endpoint.

Verify

Compare API response, delivery events and billing before rollout.

Then onboard the intended account using Meta's current guide and test a consented marketing template through the Marketing Messages API endpoint. Compare the synchronous response, later status webhook, category, and billed delivery separately. Meta says most integrations may take about two weeks, but that is an average in its notice, not a deadline or a guarantee for a particular application.

  1. List active Cloud API marketing senders and their Messaging account IDs, numbers, templates and languages.
  2. Confirm terms acceptance, permissions and onboarding for the intended Marketing Messages API account.
  3. Build category-aware routing and handle Meta's completed template-category updates.
  4. Send a small consented pilot and reconcile response, delivery, category and billing evidence.
  5. Move campaigns in stages, retain a rollback decision, and monitor failures before the relevant 2027 date.

Part 05

What this guide does and does not establish

This guide follows Meta's 21 October developer notice and its Marketing Messages API overview, which was marked updated 13 October 2026 when checked on 22 October. Meta's category-routing document was marked updated 21 September 2026. The later 21 October post reinforces an already documented October announcement; the April and October 2027 restrictions are future effective dates. Feature availability and some optimizations can vary by geography and account.

No Whats91 customer account, Marketing Messages API integration, terms acceptance, campaign send, billing record or webhook was inspected for this article. It does not claim that Whats91 currently offers this API in its interface or that any customer's traffic has been migrated. An account owner and the current Whats91 product team should verify the exact integration path before moving real traffic.

Questions

Frequently asked questions

Does WhatsApp Cloud API itself end in October 2027?

No. Meta's announced sunset is for marketing messages sent through Cloud API. It says Service, Utility and Authentication messages continue there.

What changes for a Messaging account created after 13 April 2027?

Meta says an account created on or after that date cannot send marketing through Cloud API. It can send marketing through the Marketing Messages API after the required onboarding.

Can existing marketing templates and phone numbers still be used?

Meta says existing phone numbers and marketing templates can be used with the Marketing Messages API. Confirm the account's permissions, terms and test outcome before changing production sends.

What if a Utility template becomes Marketing?

Route it by the latest category. Meta says reclassified Marketing traffic belongs on the Marketing Messages API; keep the category mapping current and review failed sends safely.

Has Whats91 already migrated my marketing campaigns?

This article cannot confirm a customer-specific Whats91 integration or migration. Ask the current product team to check your account, send path and delivery evidence.

Share this guide

If copying is unavailable, select the article link below.

Article link: https://whats91.com/blog/whatsapp-cloud-api-marketing-messages-sunset-2027