Fresh 2026

Developer Platform

WhatsApp Business Platform

Overview

About the platform

Access tokens

Permissions

Pricing

Authentication-international rates

AI Providers

Change billing currency via API

Conversation-based pricing (Deprecated)

Get started

Marketing messages

Overview

Get started

Features

Marketing templates

Overview

Custom marketing templates

Call permission request message template

Coupon code templates

Limited-time-offer templates

Location templates

Media card carousel templates

Guides

Onboarding

Measure conversions

Track click events

View metrics

Deep links

Send marketing messages

Onboard business customers

Pricing

Set a max price

Enroll in max price

Changelog

Utility messages

Overview

Utility templates

Call permission request templates

Location templates

Authentication messages

Overview

Authenticating users

Error signals

Authentication templates

One-tap autofill

Zero-tap

Copy code

Keyboard suggestions

Bulk management

Previews

Service messages

Overview

Types of messages

Address

Audio

Contacts

Document

Image

Interactive

URL button

List buttons

Media carousel

Reply buttons

Location

Location request

Reaction

Sticker

Text

Video

Calling

Overview

Configure call settings

Business-initiated calls

User call permissions

User-initiated calls

Session Initiation Protocol

Call button messages and deep links

Integration patterns

Integration examples

Reference

Troubleshooting

Calling sandbox account

App Review guidelines

Pricing

FAQ

Groups

Overview

Get started

Group management

Group messaging

Webhooks

Error codes

Pricing

FAQ

Catalogs

Overview

Get started

Upload inventory

Set commerce settings

Share products

Receiving responses

Messages

Catalog link messages

Catalog messages

Catalog template messages

Multi-product messages

Multi-product template messages

Product carousel messages

Product carousel template messages

Single-product messages

Single-product template messages

Partners

Overview

Become a partner

Become a Tech Provider

Become a Solution Partner

Become a Measurement Partner

Upgrade to Tech Partner

App Review

Embedded Signup

Overview

Implementation

Onboarding for Tech Providers

Onboarding for Solution Partners

Cloud API flow

Custom flows

Pre-filling screens

Pre-verified phone numbers

Bypassing phone number screens

Making website optional

App-only install

Hosted ES

Automatic Events

Versions

v4 public preview

v3 public preview

v2 public preview

Errors

Onboard Business app users (Coexistence)

Reconnect offboarded coexistence clients

Partner-initiated WABA creation

Multi-Partner Solutions

Overview

Embedded Creation

Migrate WABAs among solutions via Embedded Signup

Migrate WABAs among solutions via Meta Business Suite

Migrate WABAs among partners via Embedded Signup

Migrating customers off solutions via Embedded Signup

Migrating customers off solutions via Meta Business Suite

Add WABAs to a Multi-Partner Solution

Multi-Solution Conversations

Partner-led business verification

Pixel tracking

Manage customer assets

WhatsApp Business Accounts

Phone numbers

Overview

Registering phone numbers via API

System users

Credit lines

Webhooks

Partner support

Support

Migrate numbers among partners via Embedded Signup

Migrate numbers among partners programmatically

Business customer support

OBO model deprecation

Webhooks

Overview

Create a webhook endpoint

Create a test webhook endpoint

Override the callback URL

Webhooks reference

account_alerts

account_review_update

account_update

business_capability_update

history

message_template_components_update

message_template_quality_update

message_template_status_update

messages

Overview

audio messages

button messages

contacts messages

document messages

edit messages

errors messages

group messages

image messages

interactive messages

location messages

order messages

reaction messages

revoke messages

status messages

sticker messages

system messages

text messages

unsupported messages

video messages

partner_solutions

payment_configuration_update

phone_number_name_update

phone_number_quality_update

security

smb_app_state_sync

smb_message_echoes

template_category_update

user_preferences

Template fundamentals

Overview

Components

Languages

Categorization

Comparison

Library

Archival

Management

Overview

Migration

Configure time-to-live

Tap target URL title override

Quality and delivery

Quality rating

Review

Pausing

Business portfolio pacing

Template pacing

Messaging limits

Upcoming changes to messaging limits

Per-user marketing template limits

Messaging features

Media

Read receipts

Contextual replies

Typing indicators

Link previews

Throughput

Account assets

Business phone numbers

Overview

Two-step verification

Conversational components

Business-scoped user IDs

Business profiles

Display names

Official Business Accounts

WhatsApp Business Accounts

QR codes and message links

Timezone IDs

Analytics

Ads that click to WhatsApp

Welcome message sequences

Payments

Payments India

Overview

Onboarding APIs

UPI Intent

Dynamic VPA

Cashfree

Billdesk

CCAvenue

Payment links

Enhanced payment links

Payment gateway

Order details templates

Order status templates

Checkout button templates

Payments Brazil

Overview

Orders

Pix

Payment links

Boleto

One-click payments

Order details templates

Payment request CTA templates

Data, Privacy, & Policy

Policy enforcement

Violations

Blocking users

Data privacy & security

Local storage

No storage

Obtaining user opt-in

User identity changes

Support

API status page

Health status

Load testing

Experiments

Use an existing WhatsApp number

Resources

API Reference

Application

Application Connected Client Businesses

Application Solutions API

Solution Creation API

Business

Add Phone Numbers API

Business Account API

Client WhatsApp Business Accounts API

Owned WhatsApp Business Accounts

WhatsApp Business Accounts API

WhatsApp Business Partner Onboarding to MM Lite API

WhatsApp Business Pre-Verified Phone Number Sharing API

WhatsApp Business Pre-Verified Phone Numbers API

Groups

Groups Invite Link API

Groups Join Requests API

Groups Participants API

Groups Query API

Media

Media API

Media Download API

Message History

WhatsApp Business Message History Events API

User

Assigned WhatsApp Business Accounts API

Webhooks

WhatsApp Incoming Webhook Payload

WhatsApp Account Number

WhatsApp Account Number API

WhatsApp Business Account

Assigned Users Management API

Conversational Automation API

Extended Credits API

Message Template API

Phone Number Management API

Schedules API

Subscribed Apps API

WhatsApp Business Account API

WhatsApp Business Account Activities API

WhatsApp Business Account Solutions List API

WhatsApp Business Account Migration Intent

Migration Intent Details API

WhatsApp Business Bot

Bot Details API

WhatsApp Business Phone Number

Block API

Business Compliance Information API

Business Encryption API

Calling API

Commerce Settings API

Groups Management API

Marketing Messages API for WhatsApp

Media Upload API

Message API

Phone Number Deregister API

Phone Number Registration

Phone Number Verification Request Code API

Settings API

Verify Code API

WhatsApp Business Account Official Business Account Status API

WhatsApp Business Account Phone Number API

WhatsApp Business Profile API

WhatsApp Business QR Code API

WhatsApp Business QR Code Management API

WhatsApp Business Pre Verified Phone Number

Request Verification Code API

Verify Code API

WhatsApp Business Pre-Verified Phone Number API

WhatsApp Business Pre-Verified Phone Number Partners API

WhatsApp Business Profile

WhatsApp Business Profile Node API

WhatsApp Business Solution

Accept Deactivation Request API

Access Token API

Reject Deactivation Request API

Send Deactivation Request API

Solution Accept API

Solution Details API

Solution Reject API

Changelog

Error codes

Changelog

Updated: May 28, 2026

Get notified

Changelog (217)

Search Changelog

May 28, 2026

Cloud API

Updated the Business Scoped User IDs page. Renamed the contact request interactive message type from contact_request to request_contact_info. Fixed the parent BSUID endpoint URL to use api.facebook.com instead of graph.facebook.com.

Cloud API, Webhooks

Updated the Calling API reference page. Added BSUID and username fields to calling webhooks: to_user_id, to_parent_user_id, and contacts with username, user_id, parent_user_id for Call Connect and Call Terminate webhooks, and recipient_user_id for Call Status webhooks.

May 27, 2026

Cloud API, Pricing

Added an ISO Country Code column to the country calling codes table on the pricing page. The new column displays ISO 3166 Alpha-2 country codes (for example, US, GB, IN) alongside the existing country calling codes, supporting the migration to Business Scoped User ID (BSUID).

May 26, 2026

Cloud API, Pricing

Updated the Pricing page with upcoming rate card changes effective July 1, 2026 and October 1, 2026, including new markets moving to standalone pricing and rate card updates across 16 currencies. Updated billing localization sections for Brazil and India with migration deadlines and links to the new Currency Migration API.

Added a new Change billing currency via API page documenting the WABA Currency Migration API, which allows cloning an existing WABA into a new WABA with a different currency or payment method.

Updated the AI Providers pricing policy page with upcoming rates effective July 1, 2026.

Updated the Calling API Pricing page with upcoming rate cards effective July 1, 2026 across 16 currencies.

May 18, 2026

Embedded Signup

Added Reconnect offboarded coexistence clients, a new guide for coexistence partners. When a coexistence client re-registers their WhatsApp Business app (device switch, reinstall, or re-registration), they see a pre-checked opt-in to reconnect all previously connected Cloud API products. Reonboarding completes automatically in the background within a few minutes.

May 14, 2026

Cloud API, Groups API

Updated mark messages as read documentation. Businesses can now mark group messages as read using the same Messages API endpoint. Unlike individual messages, each group message must be marked as read individually, marking one message does not mark earlier messages in the group as read.

May 13, 2026

Cloud API

Effective June 15, 2026, Keyboard suggestions will be enabled by default for all authentication templates. On iOS 26 and later, WhatsApp users will see a native one-tap autofill prompt in the keyboard when they receive an authentication code. No integration changes are required. To opt out before this date, use the Allow autofill on iOS toggle in WhatsApp Manager.

May 12, 2026

Cloud API, Pricing

Updated the AI Providers pricing policy page. Effective May 13, 2026, Meta will no longer charge “AI Providers” for non-template messages delivered to users in EU/EEA markets. Charges for non-template messages delivered to users in Brazil remain in effect. Updated rate card CSV and PDF.

April 30, 2026

Cloud API

Updated per-user marketing template message limits documentation. Added new retry limits section describing WABA-level enforcement for excessive retry attempts.

Added new timezone IDs reference documentation listing all supported timezone identifiers for the WhatsApp Business Platform.

April 21, 2026

Marketing Messages

Marketing Messages API for WhatsApp

Additional offsite conversion metrics are now available in WhatsApp Manager and in the Template Analytics API. New metrics include: registrations completed, adds to wishlist, adds of payment info, levels achieved, ratings submitted, tutorials completed, searches, leads, content views, other, and custom events. See Viewing metrics and Setting up conversion measurement for details.

Marketing Messages API for WhatsApp

Automatic creative optimizations are now disabled by default at the WhatsApp Business Account level. You can opt in via the API or directly in WhatsApp Manager. Updated ACO documentation with refreshed content: added Dynamic CTA and Hyperlink formatting to Coming soon, and updated text formatting description.

April 20, 2026

Cloud API, Webhooks

The account_update webhook’s PARTNER_REMOVED event disconnection_info object now supports three additional reason values when your client was using both the WhatsApp Business app and Cloud API: ACCOUNT_DISCONNECTED ( enforcement or your client explicitly deleted their WhatsApp account), CHANGE_NUMBER (your client changed their phone number), and USER_RE_REGISTERED (your client re-registered on a new device). These values are part of a gradual rollout and may not be available to you immediately.

April 17, 2026

Cloud API

Added new error code 131064. The API returns this error when a WhatsApp Business account has exceeded its messaging limit due to template classification violations. This applies to both template messages and direct send messages. The restriction is automatically lifted after the enforcement period.

April 15, 2026

Cloud API, Embedded Signup

WhatsApp Business app phone numbers from Nigeria and South Africa are now supported when onboarding WhatsApp Business app users via Embedded Signup.

April 3, 2026

Cloud API, Webhooks

The account_update webhook’s PARTNER_REMOVED event now includes a disconnection_info object when your client was using both the WhatsApp Business app and Cloud API and the disconnection was due to a business downgrade or device inactivity. The object contains a reason field (BUSINESS_DOWNGRADE, PRIMARY_INACTIVITY, or COMPANION_INACTIVITY) and an initiated_by field (USER or SYSTEM). This feature is part of a gradual rollout and may not be available to you immediately.

April 1, 2026

Cloud API, Pricing

Updated per-message rate cards with rate changes for Saudi Arabia, India, Pakistan, and Turkey. Introduced 8 new billing currencies for both messaging and calling: AED, ARS, CLP, COP, MYR, PEN, SAR, and SGD.

March 27, 2026

Cloud API, Conversational Components

Removed the request_welcome webhook and welcome message feature from conversational components. This feature is no longer supported. The enable_welcome_message parameter has been removed from the Conversational Automation API.

March 2, 2026

Cloud API, Marketing Messages API for WhatsApp, Pricing

Added upcoming rates for 2026 for the following countries:

Argentina (ARS), Australia (AUD), Chile (CLP), Colombia (COP), Euro (EUR), India (INR), Indonesia (IDR), Malaysia (MYR), Mexico (MXN), Peru (PEN), Saudi Arabia (SAR), Singapore (SGD), United Arab Emirates (AED), United Kingdom (GBP), United States (USD).

February 19, 2026

Marketing Messages

Marketing Messages API for WhatsApp

Added a new Automatic Creative Optimization type: Auto promotion tag.

February 19, 2026

Messages

Webhook Subscriptions

Cloud API

Added new unsupported message types in the unsupported messages webhook.

February 4, 2026

Webhook Subscriptions

Embedded Signup

Added account_offboarded and account_reconnected webhooks for Coexistence.

February 3, 2026

Official Business Account

Cloud API

Cloud API Groups are now available to all businesses with an Official Business Account.

January 29, 2026

Multi-Partner Solutions

Marketing Messages

Marketing Messages API for WhatsApp

Multi-solution conversations are now available for Marketing Messages API for WhatsApp.

January 28, 2026

Cloud API

Added new pricing policy for AI Providers.

Effective February 16, 2026, in countries where Meta is legally required to support AI Providers, Meta will charge AI Providers for non-template messages sent to WhatsApp users.

December 18, 2025

Message Templates

Business Management API

Added hsm_ids field to DELETE WhatsApp Business Account > Message Templates endpoint. Accepts an array of up to 100 template IDs to delete in a single request. Cannot be combined with the name or hsm_id parameters. See Delete templates by IDs.

December 8, 2025

Message Templates

Cloud API, Business Management API

Added business portfolio pacing, a new template message delivery batching mechanism that allows time to gather feedback on any template sent as part of a large-scale messaging campaign.

December 4, 2025

Marketing Messages

Marketing Messages API for WhatsApp

Businesses that use Marketing Messages API for WhatsApp can now view metrics for quick replies.

December 3, 2025

Marketing Messages

Cloud API

Coupon code templates now support codes with up to 20 characters, instead of 15.

December 1, 2025

Business Encryption

Cloud API

Added No Storage, an alternative Local Storage configuration. With No Storage, in-transit data is kept for a shorter period of time, and at-rest data is not persisted.

November 26, 2025

Embedded Signup

Added a note in embedded signup indicating users may experience a new completion flow for all versions. A new View your setup guide button will take users to a new setup guidance page in the WhatsApp Manager, which will provide next steps on:

Business verification Resolving integrity issues and accessing Business Support Home Sending the first message via a partner solution Sending business-initiated messages using templates

November 25, 2025

Messages

Webhook Subscriptions

Embedded Signup

The following messages event webhooks are now supported for Coexistence in Embedded Signup:

Edit messages Revoke messages

November 19, 2025

Marketing Messages

Marketing Messages API for WhatsApp

Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.

November 11, 2025

Beginning in early December 2025, we will begin supporting Flows on WhatsApp Web. Users will be able to open, complete, and view Flow responses on WhatsApp Web companions. No action is required, this feature will be enabled automatically.

We are launching Data API version 4.0, which features improvements to the security of the Flows endpoints.

WhatsApp Flows Endpoints Security Enhancements (Data API Version 4.0)

To further protect user interactions and ensure requests are genuinely from the intended recipients, we have strengthened the security of WA Flows endpoints. Previously, the system relied on flow tokens as identifiers. While effective, we have added some improvements to the verification process.

We have introduced a robust two-signature authentication mechanism:

1. Platform-side Signature Verification: Our platform now verifies the authorization of requests for specific flow messages. This process is handled entirely by our system and does not require any changes or action from your business.

2. Flow Token Signature: Businesses now have the option to use an extra layer of authentication. This signature is generated by our system and added to the data channel request payload. This signature can be optionally used by businesses to verify that requests originate from users who received the corresponding flow message, helping ensure authenticity and security of data channel endpoints.

What Does This Mean for Businesses?

No action required for the platform-side verification; it is managed by us.

Optional enhancement: Businesses can choose to use the flow token signature authentication for added security ( More details).

To enable the improvements, set the data_api_version to 4.0 in the Flow JSON.

November 3, 2025

Messages

Webhook Subscriptions

Cloud API

Updated the unsupported messages webhook by adding details about the actual message type. Added new played status messages webhookstatus value, which indicates when a voice message is played by the Whatsapp user.

November 3, 2025

Webhook Subscriptions

Cloud API

Updated the unsupported message webhook by adding details about the actual message type.

Added new played status message webhook which indicates when a voice messge is played by the Whatsapp user.

October 31, 2025

Marketing Messages

WhatsApp Business Account

MM Lite API

Added two new Automatic Creative Optimization types: product extensions and text formatting optimization. Launched a new endpoint to support WABA-level opt-out for automatic creative optimizations.

October 23, 2025

MM Lite Onboarding

Embedded Signup

The following countries/regions are now supported for Coexistence in Embedded Signup:

Australia Japan Philippines Russia South Korea Turkey European Economic Area (EEA) European Union (EU) United Kingdom (UK)

October 20, 2025

Marketing Messages

MM Lite API

Offsite conversion metrics is now available in WhatsApp Business Manager and in the Template Analytics API. Added two new Automatic Creative Optimization features: Headline extraction and Tap-target title extraction.

October 20, 2025

Messages

Webhook Subscriptions

Cloud API

Ad click IDs will not be included in incoming text messages webhooks payloads describing an incoming message that originated from a WhatsApp Status ad placements⁠.

October 17, 2025

Marketing Messages

MM Lite API

Added marketing_messages_onboarding_status and owner_business_info fields to check Terms of Service and Intent request status for business manager.

October 17, 2025

Embedded Signup

If you don’t want to configure and host the Embedded Signup implementation code on your website or customer portal, you can now use Hosted Embedded Signup (“Hosted ES”) instead.

Hosted ES is a pre-configured implementation of Embedded Signup that is hosted by Meta. You can get a link to Hosted ES in the App Dashboard and add it to your website or customer portal. Business customers who click the link will be presented with a webpage with a “Get started” button that launches the Embedded Signup flow:

October 16, 2025

Messages

Webhook Subscriptions

Cloud API, Business Management API

Incoming media messages webhooks ( image messages, video messages, etc.) now include the incoming media asset’s media URL, which is assigned to the url property. You can now designate an audio message as a voice message. Delivered voice messages appear in the WhatsApp client with a play icon, waveform graphic, profile image, and a microphone icon. If the recipient has enabled voice message transcripts⁠, a text transcription of the message can also appear:

October 14, 2025

Marketing Messages

MM Lite API

The product_policy field is now 100% rolled out for businesses customers.

October 8, 2025

Webhook Subscriptions

WhatsApp Business Account

Cloud API, Business Management API

Messaging limits are now business portfolio-based instead of business phone number-based, and the initial increase via scaling path is now 2,000 instead of 1,000. To support this change, for version 24.0 and newer requests, a new whatsapp_business_manager_messaging_limit field has been added, which returns the owning business portfolio’s messaging limit. This field is available on the following endpoints:

GET /<BUSINESS_PORTFOLIO_ID> GET /<WHATSAPP_BUSINESS_ACCOUNT_ID> GET /<BUSINESS_PHONE_NUMBER_ID> For version 24.0 and newer requests, the messaging_limit_tier on the GET /<BUSINESS_PHONE_NUMBER_ID> endpoint now returns the owning business portfolio’s messaging limit. For version 24.0 and newer requests, added error code 131059 which is returned when querying the GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates endpoint with an invalid pagination cursor. If you get this error, retry your request without before or after cursors. This will generate and return new cursors for paginated responses. For version 24.0 and newer requests, the status messages webhook no longer includes the conversation object, unless the webhook is for a message sent during an open Free Entry Point window.

Embedded Signup

Embedded Signup version 4 is now available. Version 4 provides a simplified onboarding experience and allows you to onboard business customers to multiple products (WhatsApp Cloud API, Marketing Messages Lite API, Ads that click-to-WhatsApp⁠ and the Conversions API).

October 8, 2025

MM Lite Onboarding

Marketing Messages

Embedded Signup

MM Lite

Updated the onboarding page with an onboarding video tutorial.

October 6, 2025

Groups API

Introducing WhatsApp Groups API, which enables programmatic creation and management of groups on WhatsApp.

October 3, 2025

Solution providers

Access verification is no longer required to become a Tech Provider.

October 1, 2025

Cloud API, Marketing Messages Lite API, Pricing

Changed WhatsApp Business Platform rates.

Increased marketing message rates for United Arab Emirates. Increased utility and authentication message rates for Colombia. Decreased marketing message rates for Mexico. Decreased utility and authentication message rates for Saudi Arabia, Argentina, and Egypt. Zimbabwe is now mapped to our “Rest of Africa” region vs. “Other.” Messages delivered to WhatsApp users with a +263 country calling code (Zimbabwe) will now be charged “Rest of Africa” rates.

October 1, 2025

Marketing Messages

MM Lite API

Updated the support page with new troubleshooting guides.

September 29, 2025

MM Lite Onboarding

Marketing Messages

MM Lite API

Added a Coexistence onboarding guide to MM Lite. Whatsapp Business users can now onboard with their existing WhatsApp Business app account and phone number.

September 24, 2025

Cloud API

Added note in the media document when retrieving a media from a media ID received via webhook, the media ID will only be available to download for 30 days. After October 9th this will only be available for 7 days.

September 10, 2025

Starting with 10th of September 2025 the Flow version 5.0 is frozen. Please upgrade Flows on this version to the recommended version, to avoid any disruption.

We are releasing the latest Flow JSON version, 7.3, which includes improved Flow JSON validations.

Flow JSON Validation Updates

Validation for routing model and data model in Flow JSON

The Flow’s routing model's improved validation makes sure only valid routes are used for navigation. We’ve also improved the validation for the screen’s data model. These updates don't change how things work, but they make it easier to spot errors in the Flow JSON.

September 8, 2025

Call Permissions

Cloud API

Updated v3 document to display an example of the v3 syntax. Added Call Permissions Request type under interactive objects for messages.

September 3, 2025

Webhook Subscriptions

Marketing Messages

MM Lite API

On September 8th, 2025, we’re launching a new “MM Lite ToS signed” webhook, which will be sent whenever a business signs the MM Lite ToS via any method (e.g. Embedded Signup, or in WhatsApp Manager). The webhook will have a more descriptive name than the existing AD_ACCOUNT_LINKED webhook. The older webhook will be deprecated by Jan 1, 2026.

Conversion metrics will now also be available in WhatsApp Manager UI and via the WhatsApp Business Management API. This means that we’re removing the ability to view MM Lite metrics for read-only Ad Accounts in Ads Manager.

The /marketing_messages endpoint will accept marketing messages for both MM Lite API and Cloud API.

August 27, 2025

Messages

Call Permissions

Embedded Signup

Updated v3 document to display an example of the v3 syntax.

Cloud API

Added Call Permissions Request type under interactive objects for messages.

August 22, 2025

Marketing Messages

MM Lite API

Added a features page comparing MM Lite and Cloud API features.

MM Lite API uptime and availability metrics are now live on metastatus.com⁠, providing visibility into service status.

August 14, 2025

Embedded Signup

In September we are simplifying the Embedded Signup flow across all versions. You can preview the simplified flow by configuring Embedded Signup with v#-public-preview (e.g. v3-public-preview) and launching the flow. See Versions for additional details.

August 12, 2025

Webhook Subscriptions

MM Lite Onboarding

Cloud API

Added AD_ACCOUNT_LINKED event to the account_update webhook, which triggers when a WABA has onboarded to MM LITE through Embedded Signup or Intent API giving the partner access to its ad accounts.

August 11, 2025

Business Management API

Added Welcome Message Sequences, which allow you to populate a set of pre-defined text and FAQs or a prefilled message, that can appear in a WhatsApp thread when a user taps a Click-to-WhatsApp ad.

August 6, 2025

Marketing Messages

MM Lite API

Added a image background generation field for automatic creative optimization.

August 4, 2025

Cloud API

Added new whatsapp_business_manage_events permission to log events.

July 30, 2025

Message Templates

Cloud API

Changed the Media Card Carousel Template requirements so that card body text is no longer mandatory.

July 25, 2025

Marketing Messages

MM Lite API

Updated references to “Mobile App ID” to “Meta App ID” when creating a template to avoid confusion. Added a Template-to-ad-syncing guideline for clients to follow to ensure all templates be set up for conversion metrics.

July 25, 2025

Message Templates

Cloud API

Added the Tap target title URL override message template.

July 22, 2025

Marketing Messages

MM Lite API

Local Storage is now available for MM Lite. If you have already enabled Local Storage for the Cloud API, your existing settings are automatically applied to the MM Lite API.

July 16, 2025

Marketing Messages

MM Lite API

Added a troubleshooting guide on how to identify admins of a business portfolio using Meta Business Suite or the API. Both methods return the same results.

Meta Business Suite⁠: Navigate to the Business Settings to view users with Full Control access. API: GET /<WHATSAPP_BUSINESS_ACCOUNT_ID> and GET /<BUSINESS_PORTFOLIO_ID>/business_users endpoints to get a list of business portfolio admins.

July 15, 2025

Marketing Messages

MM Lite API

Added marketing_messages_onboarding_status field which provides more granular eligibility status data. The field will be a replacement for marketing_messages_api_status field which will be deprecated in version 24.0. Fixed the marketing_messages_lite_api_status field to correct a bug which was erroneously returning ELIGIBLE when it should have returned ONBOARDED. This field will be deprecated in version 24.0, so we recommend using the new marketing_onboarding_status field instead. Changed the marketing_messages_api_status field to no longer require one or more registered phone numbers, or one or more MM Lite API-ready templates, in order for ONBOARDED to be returned.

July 15, 2025

Multi-Partner Solutions

Calls

Cloud API

WhatsApp Business Calling API now available.

WhatsApp Business Platform

Multi-solution Conversations is now available in open beta

Multi-solution Conversations enables businesses to use multiple partners and solutions on the same phone number, enabling a seamless chat thread experience for their customers.

July 8, 2025

On 9th of September 2025 Flow version 5.0 will freeze. Please upgrade Flows on this version to the recommended version, to avoid any disruption.

This release introduces Flow JSON version 7.2, with improvements to the Flow JSON validations.

Component updates

Validation for nested expressions in Flow JSON actions

Nested expressions used in actions are now validated to ensure referenced variables in the data model exist. This doesn’t add any functional change, but makes it easier to spot errors on Flow JSON.

July 7, 2025

Webhook Subscriptions

WhatsApp Business Profile

Business Management API

Added PROFILE_PICTURE_LOST as a new alert_type to account_alerts webhooks, to notify you when a business phone number’s business profile photo has been deleted.

July 1, 2025

Marketing Messages

MM Lite API

Per-message pricing now applies to MM Lite API! See Pricing on the WhatsApp Business Platform to learn more.

July 1, 2025

Cloud API

Per-message pricing is now live.

June 24, 2025

Marketing Messages

MM Lite API

Permissions

The ads_read permission is now optional for partners. This change impacts the Intent API and the Embedded Signup onboarding flows. Prior to this change, partners had to apply for App Review to get advanced access for this new permission, regardless of whether or not their app intended to call the Insights API for conversion metrics. Now, partners only need to request advanced access for this permission via App Review if their app intends to use the Insights API.

Automatic Creative Optimizations

Added text overlays and image animation Automatic Creative Optimizations. Like other optimizations, these are enabled by default on all templates, but can be disabled upon template creation, or when editing a template.

June 20, 2025

Marketing Messages

MM Lite API

Businesses in Russia who were previously unable to send messages via MM Lite API can now do so. Note that these businesses will not have access to some advanced features, but can still take advantage of all other benefits, such as exclusive marketing features. For more details, see Geographic availability of features.

June 18, 2025

Embedded Signup

Solution Partners can now claim sandbox accounts.

June 13, 2025

Official Business Account

Phone Numbers

Cloud API

You can now request Official Business Account status via API and edit your display name via API. Before you could only do this using WhatsApp Manager.

June 10, 2025

On 9th of September 2025 Flow version 5.0 will freeze. Please upgrade Flows on this version to the recommended version, to avoid any disruption.

We are releasing the latest Flow JSON version, 7.1, with a new component and several enhancements.

Component Updates

Update to the ChipsSelector component

We are updating the ChipsSelector component to align its behaviour with other list selection components (i.e. CheckboxGroup, RadioButtonsGroup and Dropdown). The ChipsSelector component can now:

Be used inside If/Switch components

Have “on-select-action” and “on-unselect-action” properties defined at its root.

Image Carousel component

The Image Carousel component allows users to slide through multiple images.

June 10, 2025

Marketing Messages

MM Lite API

Added two new Insights API fields so you can get read rate and click rate benchmarks via API instead of only via WhatsApp Manager:

marketing_messages_read_rate_benchmarkmarketing_messages_click_rate_benchmark

June 5, 2025

Webhook Subscriptions

Embedded Signup

Embedded Signup now gives business customers the option to have us automatically identify purchase or lead gen events in message threads that originate from ads that click to WhatsApp.

To be notified of these events, you can subscribe to the new new automatic_events webhook, and optionally, report them via Conversions API. See Automatic Events API for more details.

June 4, 2025

Webhook Subscriptions

Phone Numbers

Business Management API

A phone_number_quality_update webhook with event set to THROUGHPUT_UPGRADE and current_limit set to TIER_UNLIMITED will now be triggered if your business phone number is upgraded to higher throughput.

May 29, 2025

Cloud API

Added error code132018 for help diagnosing invalid parameters when attempting to send a template message. Applies to version 23.0 and newer versions.

Embedded Signup

Version 3 is now available. As part of this release, we have introduced versioning that will align with Graph API’s release cadence. The following changes apply to version 3:

only_waba_sharing is no longer a valid extras.featureType value, since bypassing the phone number screen is obsolete now that business customers are able to complete the flow with a verified business phone number, unverified number, or no number at all. Added extras.version which must be set to 3 to enable version 3. Added extras.features for enabling Marketing Messages Lite API and App-Only Install onboarding. Added extras.features.api_access_only for enabling App-Only Install onboarding. Enabling Marketing Messages Lite API onboarding must now be done through the extras.features instead of extras.featureType. Session info will be automatically enabled for all users. Partners will still have to add an event listener on the same window to process incoming information. coexistence is no longer a valid extras.featureType value, you must use whatsapp_business_app_onboarding to launch the Whatsapp Business App onboarding flow. Measurement partners currently cannot use version 3. Pre-filled data will no longer bypass any screens, to provide business customers the opportunity to review and change data.

May 23, 2025

Marketing Messages

MM Lite API

Added Android deep link support.

May 21, 2025

Marketing Messages

MM Lite API

Added an Error messages section to WhatsApp Manager that shows a summary of errors encountered by your templates within a given period of time.

May 20, 2025

Marketing Messages

MM Lite API

Added new error codes to help diagnose messaging errors. These will be available with Graph API version 23.0.

134100134101134102134103

May 5, 2025

MM Lite Onboarding

Embedded Signup

Solution providers can now onboard WhatsApp Business app users who have a WhatsApp Business app phone number with an India country dialing code.

April 16, 2025

Marketing Messages

MM Lite API

Limited access available for tracking click events.

We are offering a limited roll-out of webhook access to click events on marketing messages sent using MM Lite. Read the “Tracking click events” page for more information

April 11, 2025

Marketing Messages

MM Lite API

Early access to Automated Creative Optimizations

We are piloting a new optimization capability exclusive to MM Lite API (not available on Cloud API), which automatically enhances the visual appeal and engagement of marketing messages. Similarly to Advantage+ creative, this capability tests minor variations of your existing image header with different crop orientations or color filters, and automatically selects the variant which is getting the highest click-through rate over time with no input needed from you.

A small group of businesses will be getting early access to this feature starting May 5, with the ability to opt Templates out via the message template API. For more details, see Automated Creative Optimizations.

Please reach out to your partner, if you would like to be included in early access to this feature.

April 9, 2025

Template Categorization

We no longer support the allow_category_change property during template creation. Previously, if set to true in a template creation request, this allowed us to update a template’s category to marketing, if we determined marketing to be its category per its content and our guidelines. This is now the default behavior.

April 8, 2025

Starting April 8th, 2025 Flow versions 2.1, 3.0, 3.1, and 4.0 are now frozen. Please upgrade Flows on these versions to the recommended version, to avoid any disruption.

Message template updates

Flows can now be sent with other buttons in message templates

You can now send message templates with a Flow and other types of buttons as part of the same message.

An icon can now be selected for different types of Flows, and a default icon will be displayed if none is selected. This will not affect templates that have already been sent.

You can create message templates from WhatsApp Manager⁠ or directly via API.

April 8, 2025

Messages

Cloud API

Added typing indicators so you can let WhatsApp users know that you are preparing a response.

April 2, 2025

WhatsApp Business Account

WhatsApp Manager

Added ability to create and share WhatsApp Business Accounts using WhatsApp Manager.

April 1, 2025

Marketing Messages

MM Lite API

MM lite is now in Open Beta

With this update, MM lite has:

Self-signup for all partners and businesses. All businesses and solution providers (including Solution Partners, Tech Providers and Tech Partners) can now use self-serve onboarding flows to onboard to MM Lite API. See documentation on Onboarding for more details. Global availability. MM Lite API is now available in all regions where Cloud API is also available. Note that while the API is available, some geographic variation of features may apply, see details here.

April 1, 2025

Pricing

Lowered authentication-international pricing rates for Egypt, Nigeria, Pakistan, and South Africa.

March 31, 2025

Cloud API, On-Premises API

Payments API for business portfolios with Singapore addresses is no longer available.

March 27, 2025

Marketing Messages

Message Templates

MM Lite API

Updates to character and emoji limits in Templates

This update applies across all Templates on the Business Messaging API, and is not specific to MM Lite API (also applies on Cloud API).

As part of our ongoing efforts to improve the performance and user experience of our messaging platform, we are introducing changes to the body component of marketing templates via Cloud API and MM Lite API. These changes will impact the character limits and emoji usage in the body component, depending on the format and tag of the template.

Key Updates:

Character limits for the body component will vary based on the template format and tag The number of emojis allowed in the body component may also be limited.

These updates are designed to enhance the performance and user experience of our messaging platform. While these changes may require some adjustments to your template creation process, they can ultimately lead to better performance and engagement with your customers.

March 20, 2025

WhatsApp Business Account On-Behalf Requests

Cloud API

Added partner-initiated WABA creation to replace the On-Behalf-Of (“OBO”) account ownership model, which is being deprecated. Starting September 30, 2025, WABAs can no longer be onboarded to the OBO model.

March 11, 2025

Flow JSON version 7.0 is now available with component improvements.

Component updates (Flow JSON Version 7.0)

New property “label-variant” on TextArea and TextInput

You can now utilize the label-variant: 'large' attribute to display a large label on TextArea or TextInput components. This feature allows the label to be positioned above the input field, accommodating up to 4 lines of text for improved readability and user experience.

Update to on-select-action behaviour

In Flow JSON version 6.0, we introduced a breaking change that triggered the on-select-action at the component level when a new screen was rendered. This same functionality is present in Flow JSON versions 6.1, 6.2, and 6.3.

Reversion of this Change: We are reverting this change in Flow JSON version 7.0. From this version onwards, if an on-select-action is present on the component level, it will not be triggered when a new screen is rendered. This behavior is identical to that of Flow JSON versions 5.1 and older.

Form validations introduced for init-values and error-messages

We've introduced type checking for init-values and error-messages properties in the Form component. This ensures that values match the expected types where they're used.

For example, a TextInput with input-type="number" will only accept numeric init-values. Non-numeric values will trigger an error message.

February 27, 2025

Marketing Messages

App Dashboard

Added additional tiles to the App Dashboard > WhatsApp > Quickstart panel to make it easier for you to get started with complementary products that can help you scale business messaging:

Marketing Messages Lite API Conversions API Marketing API

These tiles make it easier to find documentation for these products and automatically add required permissions to an App Review request, which you can review and submit at your convenience.

Note that these tiles only appear for products that you are eligible to use.

February 14, 2025

Message Templates

Cloud API

Added new endpoints to support template groups and template group analytics, which allows you group sets of templates for easier analytic analysis.

Added GET /<WABA_ID>/template_groups Added POST /<WABA_ID>/template_groups Added GET /<WABA_ID>/template_group_analytics Added GET /<TEMPLATE_GROUP_ID> Added POST /<TEMPLATE_GROUP_ID> Added DELETE /<TEMPLATE_GROUP_ID>

February 11, 2025

MM Lite Onboarding

Embedded Signup

Added ability for solution providers to onboard WhatsApp Business app users via Embedded Signup (aka “Coexistence”).

February 1, 2025

Pricing

Lowered authentication pricing rates for Egypt, Malaysia, Nigeria, Pakistan, Saudi Arabia, South Africa, and the United Arab Emirates.

Added authentication-international pricing rates for Egypt, Malaysia, Nigeria, Pakistan, Saudi Arabia, South Africa, and the United Arab Emirates.

January 23, 2025

Embedded Signup

Added ability for business customers of solution providers to claim “555” business phone numbers when onboarding via Embedded Signup.

January 16, 2025

Cloud API

Added the Block API giving businesses the ability to manage unwanted spam by blocking or unblocking specific customer phone numbers.

January 14, 2025

This release includes the latest Flow JSON version, 6.3, with a new component and tooling improvements.

Component updates (Flow JSON version 6.3)

Chips selector component

The Chips Selector component simplifies tasks, such as selecting preferences or time slots, by presenting options in a compact and interactive format.

Footer supported with RichText component

The RichText component can now be used in conjunction with the Footer component on the same screen, allowing the Flow to navigate from or end at a screen that includes RichText.

Developer tooling improvements

Some Flow APIs have been simplified, making them easier to create and send:

Published Flow can be created in a single API call

Two new optional parameters (flow_json, publish) are now available in the Create Flow API call, which allow you to provide the Flow JSON and publish the new Flow immediately. Previously, at least three API calls were required (Create Flow, Update Flow JSON, and Publish Flow).

Simplified send Flow API call

The number of required parameters for sending a Flow has decreased. You now only need to specify flow_message_version, flow_cta and flow_id/flow_name. The rest of the parameters are now optional.

Simplified creation of message template with a Flow

Similarly, the number of required parameters has decreased for creation of message template with a Flow. Only text, and flow identifier flow_id/flow_name/flow_json need to be provided for Flow button. The rest of the parameters are now optional.

January 7, 2025

Solution Migration

Multi-Partner Solutions

Multi-Partner Solutions

Added ability to migrate business customers off of Multi-Partner Solutions via Embedded Signup and via Meta Business Suite. Both methods skip business phone number re-verification. Added app_id parameter to the POST /<WHATSAPP_BUSINESS_ACCOUNT>/set_solution_migration_intent endpoint to allow for migration off of Multi-Partner Solutions.

December 10, 2024

This release introduces a new Flow JSON version with a new component and several tooling improvements.

Component updates (Flow JSON version 6.2)

NavigationList component

The Navigation list offers a user-friendly way to explore multiple options within a Flow. Each list item enables navigation and can display a range of content, including text, images, and tags, making it easy for users to move between different screens in the Flow.

Regular expressions supported in TextInput component

Introduced a new pattern property to enable regular expression validation for text inputs with input-type as text, password, passcode and number.

Developer tooling improvements

This release also adds some features to the API, and makes some of those available on the Builder:

Published Flows can be edited from the Builder

All new Flows could be edited from the API since November, and now they can also be edited from the Flows Builder on WhatsApp Manager. This enables changes to be made directly within the same Flow, allowing messages to be sent with the updated content using the same Flow ID, eliminating the need to recreate the Flow.

API to migrate (copy) Flows from one WABA to another

Flows can be migrated from one WhatsApp Business account (WABA) to another owned by the same business. Migration doesn't move the source Flows, it creates copies of them with the same names in the destination WABA. migration API documentation and included in the Flows API Postman collection.⁠

Endpoint encryption examples in C# & Go

Example code is now available for Flows endpoint in C# here⁠ and in Go here.⁠

Flow previews can be shared from the Builder

A new share button will generate the preview URL without the need to use the existing API, so it can be shared with other users and embedded as an iframe into other applications.

New Flow JSON deprecation webhooks

Introducing new webhooks when the Flow version is about to be frozen or expired. These warnings will also be visible on the Builder.

December 10, 2024

Embedded Signup

Added Sandbox accounts for easier testing of the Embedded Signup flow.

December 1, 2024

Marketing Messages

MM Lite API

USA availability, and checking MM Lite eligibility via API

Businesses in the USA are now eligible to use the MM Lite API.

In addition, a new MM Lite enrolment parameter allows businesses and partners to programmatically check MM Lite eligibility. See API docs for details.

November 18, 2024

Marketing Messages

MM Lite API

Reduced sync and async latency

MM Lite team has quickly responded to feedback on “async” or “delivery” latency. This is defined as the time between an API call being received by MM Lite API, and MM Lite API dispatching a “delivered” webhook, assuming a user is online when the message is sent.

MM Lite previously had a p99 “async” delivery time of 12s, vs. p99 of 5s on Cloud API. This time has now been reduced to 9s. No action is required on a business or partner’s part.

November 18, 2024

Webhook Subscriptions

Marketing Messages

Cloud API

Added user preferences for marketing messages. Added user_preferences webhook field for user preferences for marketing messages. Added error code 131050 for messages webhooks, indicating message non-delivery due user marketing preferences.

November 15, 2024

Marketing Messages

MM Lite API

New easier onboarding flow, for partner-managed businesses

MM Lite is rolling out a new way for partners to guide a business through signing the MM Lite Terms of Service and moving to MM Lite.

In parallel with the Embedded Signup flow already available, a partner will also alternatively be able to initiate the following flow:

Call an ‘Intent API’ endpoint to indicate a BMID the partner wishes to assist in migrating to MM Lite. (If a BMID contains any OBO WABAs, these must be migrated to ‘shared’ prior to this event). Admins of that BMID will receive a notification that they have been invited to start sending marketing messages with optimizations via MM Lite. This notification is in Business Manager and via email. Once accepted, and MM Lite setup and Ad account syncing is complete, a webhook will be triggered to the partner and all subscribers indicating that MM Lite onboarding is complete, and including the linked Ad IDs. The partner may now call the “send” endpoint of MM Lite on this business’ behalf, and call an API to fetch an updated token with permission to access the business’ Ad account metrics.

See API docs for details on this new onboarding flow.

November 13, 2024

WhatsApp Business Account Users

WhatsApp Business Account

Cloud API

Added GET /<SOLUTION_ID>/access_token endpoint for getting business tokens of business customers who have onboarded to the platform via a Multi-Partner Solution.

November 12, 2024

We are releasing 2 new Flow JSON versions, alongside some exciting tooling improvements:

Component updates (Flow JSON Version 6.1)

CalendarPicker component

New component that allows users to select a single date or a range of dates from a more user-friendly full calendar view making it easier to navigate dates and visualize date availability.

Flow JSON Version 6.0

Version 6.0 introduces three backwards incompatible changes:

String values in component properties can't be empty. Previously values such as “”, “ “, “\n”, “\t”, “\n” were accepted; from version 6.0 these are no longer valid.

Maximum image size for list components (Checkbox Group, Radio Buttons Group, Dropdown) is reduced from 300KB to 100KB.

If on-select-action is present on the component level, it will be triggered when the new screen is rendered, whether via cache or back-and-forth navigation.

This new version is fully available now, and introduces the following new features:

Nested Expressions and string concatenation in component properties

Boolean expressions and string concatenation can now be used in component properties. Expressions can combine static and dynamic data.

New update_data action

A new action has been added to support dynamic updates of the current screen based on user interactions. This action can be used to update elements on the same screen in response to user inputs, handle dynamic data relationships, promote reusable templates, and more.

New on-unselect-action property

A new property has been added to several components that works similarly to the existing on-select-action but will allow changes made by the update_data operation in the on-select-action to be reverted.

OptIn and EmbeddedLink can now open external links

A new action open_url can be used in on-click-action to open external links in Flows from EmbeddedLink and OptIn components. These external links will open in the device's default browser.

Developer tooling improvements

We are introducing a new page within the Builder, and improvements to the API and onboarding through the UI:

Business insights

Statistics on how consumers interact with your Flows can now be found on the builder on published Flows. These metrics help track Flow performance and reveal usage trends, including the count of user interactions with Flows.

Published Flows can now be edited

All new Flows can be edited by updating their metadata or Flow JSON via API, even after they have been published. This enables changes to be made directly within the same Flow, allowing messages to be sent with the updated content using the same Flow ID, eliminating the need to recreate the Flow.

Simplified Flows onboarding

All businesses can now start creating and building Flows. To send and publish a Flow, business verification and high message quality are still required.

November 12, 2024

Solution Migration

Multi-Partner Solutions

Cloud API

Added POST /<WHATSAPP_BUSINESS_ACCOUNT>/set_solution_migration_intent endpoint to enable Tech Providers to migrate business customers from one Solution Partner and Multi-Partner Solution to another Solution Partner and Multi-Partner Solution.

November 8, 2024

Marketing Messages

MM Lite API

App Conversion reporting now supported

Businesses can now use MM Lite API to measure when marketing messages lead users to perform app events, such as purchases, searches, or achieving levels in games. See Integrate with App Conversions for details.

November 5, 2024

Conversational Automation

Cloud API, Business Management API

Added POST /<BUSINESS_PORTFOLIO_ID>/self_certify_whatsapp_business endpoint for partner-led business verifiation.

November 1, 2024

Cloud API, Pricing

Service conversations are now free for all businesses, including via AI-enabled conversational experiences.

November 1, 2024

Marketing Messages

MM Lite API

Metrics in WhatsApp Manager

To represent this new conversation type, MM Lite API conversations are available in every surface where reporting is offered:

Ads Manager UI [recommended] Marketing API “Insights API” [recommended] WhatsApp Manager UI “WABA Insights” page and “Template Insights” page Business Management API Pricing webhooks

For full details on how to see MM Lite API metrics via API and in pricing webhooks, consult the MM Lite API docs.

In the Marketing API “Insights API” response, MM Lite events can be return using fields named marketing_messages_[event] In the Business Management API “Template Analytics” endpoint, MM Lite events can be returned using the query parameter MARKETING_MESSAGES_LITE_API In the Business Management API “Conversation Analytics” endpoints, MM Lite events can be returned using the product_type query parameter `MARKETING_LITE’ In message status webhooks, the conversation:origin:type and pricing:category fields will show as marketing_lite

Businesses can now see MM Lite metrics as “Marketing - lite” in the WhatsApp Manager UI:

We recommend you integrate with the Marketing API “Insights API” for MM Lite Metrics, and encourage end businesses to log into Ads Manager UI to see their metrics, instead of using the WhatsApp business surface. Ads Mgr UI and Insights API show conversion metrics that are not available on WhatsApp surfaces, and will continue to support new metrics and features as the primary surface for MM Lite API reporting as the API grows.

API docs for partners have been updated to reflect how to fetch MM Lite metrics via API.

API docs have been updated to reflect how to fetch MM Lite metrics via API, see Viewing metrics.

October 30, 2024

Marketing Messages

Message Templates

MM Lite API

Exclusive feature: TTLs for Marketing messages

We continue to invest to improve consumer experiences and business outcomes. We are introducing customizable message validity periods (time-to-live or TTL) for marketing messages on MM Lite API, to ensure marketing messages are always timely and relevant for users thus performant for businesses. We are also updating our customizable range for TTL for utility and authentication templates, to provide businesses more control and flexibility.

Marketing: From 12 hours to 30 days, for businesses on MM Lite API Utility: From 30 seconds to 12 hours, for businesses on Cloud API Authentication: From 30 seconds to 15 minutes, for businesses on Cloud API or On-Premises API

Businesses can customize the TTL of marketing, utility and authentication templates during template creation via WhatsApp Manager (via pre-set increments) and via API (in 1-second increments). This is reflected in our dev docs and Business Help Center⁠.

October 15, 2024

Marketing Messages

MM Lite API

New rate cards and pricing category for MM Lite

Marketing message conversations initiated via MM Lite API are counted and billed separately from Marketing message conversations initiated via Cloud API. This includes updates to pricing webhooks. For details, please see Pricing.

October 11, 2024

Solution Migration

Multi-Partner Solutions

Business Management API

Added POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/set_solution_migration_intent endpoint for adding a WABA to an active multi-partner solution.

October 8, 2024

We are adding some tooling improvements to both the API and Flows Builder.

Flows can be referenced by name using the API

Flow messages can be sent using the Flow's name instead of its ID, which is useful when you have clones of the same Flow in multiple WhatsApp Business Accounts with different Flow IDs.

You can also create a message template with a Flow using the Flow's name.

Flow JSON can be used when creating Message Templates through the API

It is now possible to provide Flow JSON as part of the request payload when creating Message Templates with a Flow attached, so you don't need to create and publish a Flow as a previous step.

Endpoint setup on Flows builder has a dedicated section

Flows with endpoint can be configured on a dedicated tab at the bottom of the Flows builder. Other endpoint-related features can also be found there, such as snippets and links to the documentation.

October 2, 2024

Message Templates

Phone Number Registration

Cloud API

Starting with version 21.0 the package_name and signature_hash parameters must be defined within the supported_apps array when creating one-tap autofill and zero-tap authentication templates. Starting with version 21.0, to enable local storage on a business phone number, the number must be in an unregistered state, and you must use the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/settings endpoint to enable local storage before registering the number (instead of enabling during registration). To support these changes:

Added a storage_configuration parameter to the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/settings endpoint, which can be used to enable or disable local storage. Removed the data_localization_region parameter from the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER>/register endpoint.

October 1, 2024

Cloud API, Pricing

Updated pricing rates in India, Saudi Arabia, the United Arab Emirates, and the United Kingdom.

September 25, 2024

Cloud API

Changed steps in the App Dashboard to make it easier to become a Tech Provider.

September 24, 2024

Message Templates

Cloud API

Added checkout button templates (only available to India businesses that use business phone numbers with India country calling codes).

September 16, 2024

New Flow JSON version - 5.1

We are introducing a new Flow JSON version which contains a new component and several enhancements.

RichText component

You can use this component to render text with rich formatting options. The following markdown syntax is supported:

- Heading and Subheading

- Text formatting (italic, bold, strikethrough)

- Basic lists

- Links

- Images

- Tables

TextBody and TextCaption can use markdown

A new property "markdown" can be used with both components, which allows to use a subset of the RichText capabilities.

Flow termination message has a new look

SMBs are now able to view the responses received for Flows completion and download them in CSV format. Consumers will soon also be able to view the information submitted when completing the Flow.

In Flow JSON, certain fields can now be marked as "sensitive" so that data for those fields is not visible as part of the response details displayed to the user.

Developer tooling improvements

We are making it easier to preview Flows and integrate into existing websites.

Web preview now can be used in interactive mode and inside an iframe

The preview URL can be configured with new parameters to make it interactive and show a debug panel. It works with Flows with and without an endpoint.

It can also be embedded as an iframe, so it can be integrated into an existing website.

Flows data endpoint improvements

We have increased the payload limit of the Flows data endpoint to 10MB, allowing for the transmission of multiple images to screens using list ( RadioButtonsGroup, CheckboxGroup, Dropdown) and RichText components.

September 11, 2024

Marketing Messages

Cloud API

Added single-product message templates. Added product card carousel templates.

September 10, 2024

Cloud API

Changed media asset caching behavior from developer definable (via Cache-Control header) to a fixed time period of 10 minutes. You can still force us to fetch assets from your server instead of our cache, however. See Media Caching.

September 6, 2024

Multi-Partner Solutions

WhatsApp Business Account

Cloud API

Added Messages business asset access for more granular control of WhatsApp Business Account access. Added ability to create Multi-Partner Solutions via embeddable button.

August 13, 2024

New Flow JSON version - 5.0

This release introduces a new Flow JSON version which contains several enhancements. This is the recommended version to use if you are creating a new Flow.

Upgrading Flows to version 5.0 from 4.0: Version 5.0 introduces a backwards incompatible change:

All DatePicker components now receive and set dates in “YYYY-MM-DD” format, which makes the values unrelated to time zones ( more details).

No additional changes are required to port a Flow from version 4.0 to 5.0, which will unlock your access to the following new functionality:

Images and colors are now available in Pickers

Added support for displaying images and colors in list components ( RadioButtonsGroup, CheckboxGroup, Dropdown).

Media upload components: Increased limit for the number of media files sent as part of the response message

It is now possible to have up to 10 media files sent as part of the response message, with the combined size of all files up to 100MB.

Developer tooling improvements

This release introduces a few improvements to help developers onboard and debug Flows with endpoint.

New health status endpoint for Flow Graph API

It is now possible to query flow health status using new health_status field and get status of Flow health and other related entities like WABA, Business which are involved in message sending ( more details).

New templates and development guides

New refined templates are now available in Flows Builder with dedicated development guides and endpoint templates ready to use.

You can find them under the Flow creation screen on WhatsApp Manager, or following the links below:

Pre-Approved Loan Health Insurance Personalised offer Purchased Intent

Improved error details for Flows with endpoint

More detailed errors when using an endpoint are displayed on draft mode on mobile, and on the Builder in WhatsApp Manager to help with debugging.

August 1, 2024

Cloud API, Pricing

Lowered utility conversation pricing rates.

July 9, 2024

Endpoint health check debugger

You can now check the status of the endpoint of your Flow with this new health check validator, which allows easy troubleshooting of any issues with encryption or health check requests. You can find it on the endpoint setup modal within the Flows Builder in WhatsApp Manager.

Actions debugger

A new panel is added to the existing Flows Builder in WhatsApp Manager, which allows viewing the data exchanged between the Flow and the Flow’s endpoint and the data passed between screens when navigating. You can find it at the bottom of the editor within the Flows Builder in WhatsApp Manager.

June 25, 2024

Marketing Messages

MM Lite API

Show MM Lite metrics on the Template Analytics API

MM Lite metrics are now available from the Template Analytics API endpoint. See documentation for details.

June 11, 2024

New Flow JSON version - 4.0

We are introducing a new Flow JSON version which contains several enhancements (described in detail below). You can now create new Flows with this version to leverage the new functionality.

Upgrading Flows to version 4.0 from 3.1: Version 4.0 introduces two minor backwards incompatible changes, which means you may need to make some tweaks after cloning an existing version 3.1 Flow. Specifically:

All CheckboxGroup and RadioButtonsGroup components now require a label property (previously optional)

The name property for all input and selection components cannot be empty. Previously values such as “”, “ “, “\n”, “\t”, “\n” were accepted; with version 4.0 these are no longer valid.

No additional changes are required to port your version 3.1 Flow to version 4.0, which will unlock your access to the following new functionality:

[Component] Image and Document upload

New PhotoPicker and DocumentPicker components. These components allow users to share images and documents, respectively, within a Flow, leveraging the existing and familiar WhatsApp UX.

[Component] Group components `label` improvements

The CheckboxGroup and RadioButtonsGroup components now support a higher character limit for the label property, and additionally support a new description property, which can be used to provide more information to users about the selection options.

[Comoponents] Conditional Component Rendering

You can now show/hide components, based on user input or Business data, without the need to trigger a data_exchange to your Flows Endpoint, by leveraging the If and Switch Components within the Flow JSON.

[Flow JSON Capabilities] Global Dynamic Data Access

You can now reference Form and dynamic data from any screen in the Flow JSON using global accessor syntax. This means you no longer need to explicitly propagate data from screen-to-screen.

[Flow JSON Capabilities] Optional Form

The use of the Form component is now optional. This means that you can access user-entered data without the need to wrap your components inside a Form component.

Developer Tooling Improvements

We are introducing several improvements to help developers onboard and use Flows.

[Developer Tools] Improved Flows Preview in the WhatsApp Manager Builder, and in Developer Docs

Better/snappier preview loading and saving performance.

Ability to simulate iOS and dark theme modes.

Mobile-like bottom sheet experience within the Flows Builder editor, which displays Flow JSON error(s).

[Developer Tools] Update Application linked to a Flow through the Flows API

Added an optional application ID parameter to the Update Flow API request.

[Developer Tools] Send-Time validation of the screen name in "navigate" action

Added validation of the screen parameter in the message payload at Flow message send time if the action is navigate: invalid screens (i.e. screens that are no defined in the Flow JSON, or screens which cannot act as a first screen) will be rejected, and an API error will be returned.

Improved Flows experience for users

We are releasing several improvements to the UX of Flows. These changes are not tied to a Flow JSON version; that is, they will apply to any Flows being actively sent.

Progress Indicator

We have introduced a new feature to visually inform users about how much progress is left to complete the Flow. This is applicable for any Flows with more than one screen.

Text Truncation improvements

Optimized the character limit strategy for components to maximize the amount of content displayed based on device resolution.

Stopping WhatsApp Flows Support on Android OS 5.x.x

As announced in May, we have now stopped support for Flows on Android devices running OS 5.x.x and older. This means that Flow messages sent to users on such devices will not be delivered, and you will receive a webhook containing a “Message Undeliverable” error. For more details on this error, please refer to the error codes documentation.

June 1, 2024

Message Templates

Cloud API

Added ability to set a custom time-to-live on utility templates.

Business Management API

Added automatic category updates to correct templates that are miscategorized according to our guidelines.

May 1, 2024

Deprecating `data_channel_uri`

v18.0 / Forward: New field endpoint_uri will be returned.

v17.0 / Backwards: Old field data_channel_uri will be returned.

Stopping WhatsApp Flows Support on Android OS 5.x.x

Starting June 11th, 2024, WhatsApp Flows will only be supported on Android OS 6.0 and newer versions. This means that businesses will no longer be able to send Flow messages to users with Android OS 5.x.x devices and will receive a webhook containing a “Message Undeliverable” error when trying to do so. For more details on error, please refer to the error codes. Additionally, starting from July 9th, 2024, users on Android OS 5.x.x devices will no longer be able to interact with any existing Flow messages.

April 10, 2024

Webhook Subscriptions

Cloud API

Added webook callback URL override on business phone numbers.

April 1, 2024

Support the Opt-in component in the Flows UI builder

Extend the support of the opt-in component in the Message Templates in Flows UI editor to allow users to add and modify an additional “Read More” screen. This feature enables you to display additional information (for example, terms and conditions) on a separate screen instead of cluttering the main Flow screen. This improves the user experience and simplifies the Flow creation process.

March 18, 2024

Conversational Automation

Cloud API

Added the Conversational Components API.

March 1, 2024

Flows template gallery

Adds a new screen for creating flow. The users can now interact with the template before using it for creating a flow.

Exposing “UpdatedAt” field

New field “UpdatedAt” exposed for the GraphAPI endpoints. The field is updated for every flow when name, status, flow json, etc. changes. The field is returned with the GraphAPI endpoint and used on the WA Manager -> Flows page.

BugFix- “form_name” will be removed from business paylaod

Bug fix for Android implementation where ‘form_name’ was unintentionally included in payload. If businesses are using this, then they may need to modify server implementations for a more sustainable setup.

February 13, 2024

Phone Number Registration

Cloud API

Changed business phone number registration/deregistration attempt limits to 10 requests per business number in a 72 hour moving window (was a one-week moving window).

February 6, 2024

Marketing Messages

Cloud API, On-Premises API

Added per-user marketing template message limits to help deliver high-quality user experiences.

February 1, 2024

Details page

Introduce a new details page that provides a clear overview of Flow endpoint performance, with data on availability, latency, requests, and errors. This page is available for published Flows with endpoint from the Flows Builder in WhatsApp Manager.

Monitoring API

Introduce a new Graph API field in WA Flow object named “metric” which allows businesses to retrieve a set of endpoint related metrics.

Send flow via WhatsApp Manager

Introduce a new feature in the Flows Builder that allows Flows to be sent directly via WhatsApp Manager. The functionality works only with phone numbers registered to Cloud API.

New flow template: appointment booking template

Add a new flow JSON template “Book an Appointment” which can be used when creating a flow in Builder. The flow template can be found here. Add an endpoint example in NodeJS that works with the “Book an Appointment” flow JSON end to end. The endpoint code is available on GitHub⁠ and Glitch⁠. Enhance the endpoint example on GitHub⁠ and Glitch⁠ to include app secret validation, endpoint error codes, script to create public/private keys, and other improvements.

January 26, 2024

Message Templates

Cloud API

Changed Cloud API template message delivery retry time-to-live from 24 hours to 30 days. You can still override this value for authentication templates. Changed biz_opaque_callback_data character maximum from 256 to 512.

January 18, 2024

Conversational Automation

Cloud API

Added Conversational Components.

January 1, 2024

Introduces support for Flow JSON version 3.1

Adds optional property success for terminal screens to indicate whether terminating on that screen results in a successful flow completion.

Use the new endpoint_uri field instead of the deprecated data_channel_uri.

API changes

Make parameter name optional for Update Flow API request.

December 18, 2023

Messages

Cloud API

Added location request messages.

December 12, 2023

Business Management API

Added cta_url_link_tracking_opted_out field on WhatsApp Message Template node for enabling/disabling button click tracking. Template analytics now include button clicks in templates categorized as UTILITY.

December 1, 2023

Adds an end-to-end example for an endpoint server in Node.js that can be edited online on Glitch. The source code is also available on GitHub⁠.

Introduces support for Flow JSON version 3.0

Removes the data_channel_uri property from Flow JSON Introduces ability to specify Flow endpoint via API or WhatsApp Manager.

WhatsApp Manager changes

Adds additional filtering options (by ID and status) on the listing page of Flows Adds support for deleting and deprecating Flows Adds the ability to clone Flows

Flows in message templates

Adds support for attaching images when creating and attaching Forms in Message Templates Adds new custom form starter template when creating and attaching Forms in Message Templates

API changes

Introduces new webhook sent at the flow creation. Deprecates the data_channel_uri field in the Get Flow API request and replaces it with the endpoint_uri field.

November 20, 2023

Message Templates

Business Management API

Added console logging to help with debugging one-tap and zero-tap authentication templates.

November 14, 2023

Webhook Subscriptions

Cloud API

Added health_status field to various nodes for checking messaging health status. Added biz_opaque_callback_data field to free-form messages for including arbitrary strings in messages webhooks.

Embedded Signup

Embedded Signup can now be used to migrate customer business phone numbers from one WhatsApp Business Account to another.

November 3, 2023

Message Templates

Business Management API

Carousel template creation now requires at least one button.

October 23, 2023

Message Templates

Business Management API, Cloud API, On-Premises API

Added zero-tap authentication messages.

October 10, 2023

Messages

Phone Number Registration

Cloud API

WhatsApp Flows is now available. Added new data_localization_region field on WhatsApp Business Phone Number > Register endpoint for enabling local storage. Added new click-to-action URL buttons for free-form interactive messages.

October 4, 2023

Message Templates

Business Management API, Cloud API, On-Premises API

Authentication templates using the code expiration warning now use the code_expiration_minutes value (instead of a default of 10 minutes) to determine if the delivered template message should display an autofill button or copy code button. Autofill buttons displayed in a delivered template message will become disabled after the amount of time indicated by the template’s code_expiration_minutes value, if present (or after 10 minutes, if not present).

October 2, 2023

Message Templates

Cloud API

Added new limited time offer templates and new limited_time_offer template component.

October 1, 2023

Initial release of the WhatsApp Flows.

Introduces support for Flow JSON version 2.1

Introduces support for Data Api version 3.0

September 27, 2023

Webhook Subscriptions

Cloud API

Added ctwa_clid property to referral object in messages webhooks. Indicates the click ID generated when the user taps an ad that clicks to WhatsApp in order to send the message.

September 18, 2023

Message Templates

Cloud API, On-Premises API

Legacy authentication templates (authentication templates without one-time password buttons) can continue to be sent, edited, and appealed until April 1, 204 (extended from October 2, 2023).

September 12, 2023

Phone Number Management

WhatsApp Business Account

Phone Numbers

Business Management API

GET request responses on authentication templates now include add_security_recommendation and code_expiration_minutes template components in component value. Added new WhatsApp Business Account Access levels for more granular control. GET requests on WhatsApp Business Account > Phone Numbers and WhatsApp Business Account > Message Templates now return error code 200 if the user identified by token has not been granted appropriate WhatsApp Business Account Access. Added Template Migration.

Cloud API

Added throughput and platform_type fields to WhatsApp Business Phone Numbers. Added Carousel Templates.

Cloud API, On-Premises API

Migrating business phone numbers that have multiconnect running 2 or more shards from On-Premises API to Cloud API automatically upgrades the numbers to higher Cloud API throughput.

August 28, 2023

Embedded Signup

Added a new boolean field, override_default_response_type. When set to true, any response types passed in response_type will take precedence over the default types.

August 15, 2023

Business Management API

Added template_analytics (in beta).

August 9, 2023

Embedded Signup

Added granular business tokens that exist at the client business level as an opt-in feature to help partners improve account security. In addition, we have updated the creation screens for Pre Filled Data.

August 8, 2023

Pre-Verified Phone Numbers

Phone Number Registration

Pre-Verified Phone Number Sharing

Cloud API

Added Cloud API localized storage status to WhatsApp Business API Status⁠ page.

Business Management API

Added copy code button component for use with coupon code templates. Increased template button component total limit to 10, quick reply buttons can now be mixed with other button types, and URL button limit increased to 2. Added template bulk management. Added template previews for previewing template text in multiple languages.

Embedded Signup

Added ability to bypass phone number selection in Embedded Signup. Added business phone number programmatic/bulk registration. Added pre-verified business phone numbers bulk registration. Added pre-verified business phone number sharing.

August 2, 2023

Pre-Verified Phone Numbers

Business Management API

Pre-verified business phone numbers now have a VERIFIED status of 28 days (up from 14).

July 11, 2023

Cloud API

Scheduling and performing an upgrade to a business phone number’s throughput no longer requires a live call. You can now specify an upgrade time when submitting a Direct Support ticket to request an upgrade to a business phone number’s throughput. Downtime for business phone numbers undergoing a throughput upgrade reduced to 5 minutes or less.

July 7, 2023

Message Templates

Business Management API

Authentication template copy code button text and autofill button text are now optional upon creation.

July 6, 2023

Embedded Signup

We are requiring Solution Partners to request the whatsapp_business_messaging permission to use the API calls on the Cloud API, hosted by Meta. There is now a permissions acknowledgement screen businesses must go through in order to complete Embedded Signup.

June 13, 2023

Messages

Message Templates

Cloud API

Added latency to the WhatsApp Business API Status Page⁠.

Business Management API

Added Business Management API error code 2494100 that indicates a business phone number is temporarily in maintenance mode.

Cloud API

Added identity change check feature. Added catalog messages. Added catalog templates.

May 26, 2023

Message Templates

Cloud API

Added error signals that can help debug authentication templates with one-time password autofill buttons.

May 23, 2023

Message Templates

Cloud API

Attempting to send a paused template in a template message using v17 or later now returns error code 132015 instead of 132001. Attempting to send a disabled template in a template message using v17 or later now returns error code 132016 instead of 132001.

On-Premises API

Attempting to send a paused template in a template message now returns error code 2061. Attempting to send a disabled template in a template message now returns error code 2062.

May 9, 2023

Messages

Message Templates

Business Management API

Added multi-product message templates.

Cloud API

Added Stripe payments (Singapore only). Added address messages for requesting customer addresses (Singapore and India only). Added 1,000 messages per second throughput.

On-Premises API

Added Stripe payments (Singapore only). Added address messages for requesting customer addresses (Singapore and India only).

May 1, 2023

Webhook Subscriptions

Message Templates

Business Management API

Added new webhooks notifying you of denials of messaging limit increases to the account_alerts webhooks field. All templates must now be categorized as AUTHENTICATION, MARKETING, or UTILITY.

April 26, 2023

Message Templates

Business Management API

Added hsm_id field to DELETE WhatsApp Business Account > Message Templates endpoint. If included, deletes a single template that matches the supplied ID (instead of deleting all templates that match the supplied name).

April 18, 2023

Phone Numbers

Cloud API

Added last_onboarded_time to WhatsApp Business Phone Number node. Indicates when a user created a business phone number on their WhatsApp Business Account by completing the Embedded Signup flow.

April 17, 2023

Phone Numbers

Business Management API

Added last_onboarded_time field to the GET /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> and GET <WABA_ID>/phone_numbers endpoints to enable sorting results by when a user last onboarded the Embedded Signup flow. If this parameter is not specified, the results are sorted in descending order.

April 11, 2023

Pre-Verified Phone Numbers

Cloud API

Added WhatsApp Business Phone Number > Business Compliance Info endpoint for adding/updating a business phone number’s India-based compliance information.

Embedded Signup

Added the following endpoints to support pre-verified business phone numbers for Embedded Signup users:

WhatsApp Business Pre-Verified Phone Number WhatsApp Business Pre-Verified Phone Number > Request Code WhatsApp Business Pre-Verified Phone Number > Verify Code Business > Add Phone Numbers In Version 2 of the Embedded Signup Flow, you can now retrieve both the phone number and WABA ID you selected by specifying the sessionInfoVersion inside the extras object at the end of the flow.

April 4, 2023

Message Templates

Business Management AI, Cloud API, On-Premises API

The first template category migration is complete. Category validation is now part of the template review process for newly created templates. Applies to version v16.0+. API responses to template creation or editing requests now include template status and template category. Applies to all API versions. Added allow_category_change parameter to POST WhatsApp Business Account > Message Templates endpoint. Added INCORRECT_CATEGORY as a new rejection reason value for template status webhooks. Templates that rely on variables now require sample values upon creation or editing. Applies to all versions. Added previous_category field to WhatsApp Message Templates. Business-initiated conversations are no longer eligible for free tier conversations. If your WhatsApp Business Account relies on the services of a Solution Partner or a Meta partner, you are exempt from these changes until June 1, 2023.

March 17, 2023

Webhook Subscriptions

Message Templates

Business Management API

Added a new template_category_update webhook subscription field. If subscribed to this field, anytime a template’s category changes you will receive a webhook indicating the template’s previous and new category. API responses to template creation and editing requests now include the template’s status and category.

March 14, 2023

Messages

Message Templates

Cloud API

You can now share location information with users by adding a Location Header in your template.

On-Premises API

Conversely, users can now share their location information with businesses via Location Request Messages.

March 1, 2023

Cloud API, On-Premises API

Migrating an India-based business phone number from On-Premises API to Cloud API no longer deletes its online selling compliance data⁠, so you no longer have to manually repopulate this data after migration.

February 15, 2023

Message Templates

Business Management API

Added a new template comparison endpoint that allows you to compare template send counts and block ratios.

February 3, 2023

Cloud API, On-Premises API

Added a new WhatsApp Business Phone Number > Commerce Settings endpoint to enable/disable the shopping cart and product catalog on individual business phone numbers. See Set Commerce Settings for Cloud API and Set Commerce Settings for On-Premises API for usage instructions and to learn how these settings can help you sell products and services.

February 2, 2023

Webhook Subscriptions

Message Templates

Business Management API, Cloud API

Graph API version 16 is now available. Changes to message template categories, API error responses, and webhooks have been introduced as part of this version.

Cloud API

Templates created or edited using v16.0 must now be categorized using one of the following categories; all other categories are no longer supported. Applies to Cloud API v16.0+. Will apply to all versions May 1, 2023. This change has been introduced to support our June 1, 2023 switch to a new conversation-based pricing model.

AUTHENTICATIONMARKETINGUTILITY Error subcodes, which are rarely used and should not be relied upon, will no longer be included in v16.0+ error responses. Use code and details instead. Error code 100 ("code":100) had multiple unique titles which indicated the nature of a given 100 error. All code 100 errors will now use Invalid parameter as their title. Old titles that described the nature of a given code 100 error have been moved to the details property. This change is also now reflected in webhooks payloads that describe a code 100 error response.

Cloud API Webhooks

The errors object in webhooks triggered by v16.0+ request errors now include message and error_data.details properties, and title values have changed for multiple error codes. Now, errors objects have the following structure and data:

[\
  {\
    "code": <CODE>,\
    "title" : "<TITLE>",\
    "message": "<MESSAGE>",\
    "error_data": {\
      "details": "<DETAILS>"\
    }\
  },\
  ...\
]

The title property value has been updated for the following error codes. Their old values now appear in error_data.details.

130470 new title is now Re-engagement message130429 new title is now Rate limit hit131045 new title is now Incorrect certificate131031 new title is now Business Account locked131053 new title is now Media upload error131027 new title is now Something went wrong131042 new title is now Business eligibility payment issue131026 new title is now Message Undeliverable131000 new title is now Something went wrong The message property value is the same as the title property value, which indicates the error code’s title. This property maps to the message property in API error response payloads. The error_data.details property now includes error code titles from the error codes listed above and describes the underlying cause of the error. This value maps to the details property in API error response payloads.

These changes are reflected in the following errors properties in error-related webhooks:

entry.changes.value.errorsentry.changes.value.messages.errorsentry.changes.value.statuses.errors

January 30, 2023

Cloud API

Unverified businesses can now initiate up to 250 conversations in a rolling 24-hour period.

January 10, 2023

Embedded Signup

We have started rolling out the new embedded signup UI.

December 13, 2022

Phone Numbers

Cloud API

Added new optional phone_number_id field to the Media endpoint. If you include this parameter and a business phone number ID, the operation will only be processed if the phone number ID matches the ID of the phone number upon which the media was uploaded.

December 8, 2022

Messages

Webhook Subscriptions

Cloud API

Cloud API HTTP media caching is out of beta and available to everyone. Cloud API will now reattempt to deliver failed webhooks notifications for up to 7 days instead of up to 30 days. See Webhooks Delivery Failure.

November 23, 2022

Webhook Subscriptions

Business Management API

Added a new template_performance_metrics field. Notifies you weekly of all template performance metrics, including messages sent count, messages opened count, and top reasons for blocks.

November 22, 2022

Webhook Subscriptions

WhatsApp Business Account

Phone Numbers

Cloud API, Business Management API, Webhooks

Webhooks

New account_alerts field:

Added a new account_alerts field. Notifies you of Business, WhatsApp Business Account, and business phone number alerts.

New account_update field values:

Added a new account_update.events value: ACCOUNT_DELETED. Indicates that a phone number has been de-registered or deleted from a WhatsApp Business Account. Added a new message_template_status_update.events value: PENDING_DELETION. Indicates a message template has been marked for deletion.

Sample Webhooks notifications that are sent when these new events are triggered:

ACCOUNT_DELETED : WhatsApp Business Account Deleted PENDING_DELETION : Template Message Pending Deletion

New WhatsApp Business Account endpoint fields

Added the following WhatsApp Business Account node fields:

country (applies to v15.0+) ownership_type (applies to v15.0+) business_verification_status (applies to all versions)

New Business portfolio endpoint filters

Added the following filter options to the Business Client Whatsapp Business Accounts endpoint:

Filter by WhatsApp Business Account creation_time field using GREATER_THAN, LESS_THAN, or IN_RANGE operators. Filter by WhatsApp Business Account ownership_type using EQUAL or IN operators.

Added the following filter options to the Business Owned WhatsApp Business Accounts endpoint:

Filter by WhatsApp Business Account creation_time using GREATER_THAN, LESS_THAN, or IN_RANGE operators. Filter by WhatsApp Business Account ownership_type using EQUAL or IN operators. Filter by WhatsApp Business Account country using EQUAL or IN operators.

Applies to v15.0 and newer.

New business phone number node fields

Added the following WhatsApp Business Phone Number node fields:

is_official_business_accountmessaging_limit_tier

In addition, you can filter WhatsApp Business Account Phone Numbers endpoint by is_official_business_account.

Applies to v15.0 and newer.

November 3, 2022

Messages

Cloud API

Messages Per Second

Cloud API now supports up to 500 (up from 350) messages per second (mps) of combined text and media messages, by request. See Throughput for details.

If you already have 350 mps it will be increased to 500 mps automatically. If you already requested 350 mps but the process has not been completed, you will receive 500 mps upon completion.

Media HTTP Caching

We are now beta testing Cloud API media HTTP caching. If you are a Solution Partner, see Media HTTP Caching to learn how to use headers in your server responses that instruct us to cache your media assets for reuse with future messages.

Document Captions

Cloud API now supports captions on documents sent to and received from customers. See Media Object in the Media reference.

October 25, 2022

Message Templates

Business Management API

Message Template Limit Increased

WhatsApp Business Accounts can now have up to 6,000 message templates if their parent business has been verified⁠ and at least one of the parent business’s WhatsApp Business Accounts has a business phone number with an approved display name⁠.

As part of this change, translated versions of a message template now count against a WhatsApp Business Account’s template limit.

October 20, 2022

Cloud API

Businesses in India can now use a credit card to pay for messages sent using the platform. See Add a Credit Card to Your WhatsApp Business Platform Account⁠.

October 12, 2022

Phone Numbers

Business Management API

You can now migrate a business phone number to and from Cloud API WhatsApp Business Accounts. See Migrate Phone Number to a Different WABA.

October 11, 2022

On-Premises API

v2.43

Starting in v2.43, there will be changes to the behavior of the contacts endpoint Responses for status will change. Regardless of whether a user has WhatsApp, it will always return valid for status in the response and a wa_id. There is no guarantee that the returned wa_id will be valid. These changes are applicable for both direct responses, as well as webhook responses for non-blocking calls Ensure your code avoids relying on status and wa_id returned in the contacts node. In addition, sending a message on v2.39.1 or higher can be completed without calling the contacts node Ensure your code handles a potential 1013 User is not valid error when trying to send a template message, which will be returned if you attempt to send the template message to a phone number without a WhatsApp account For non template messages, sending a message to a phone number without a WhatsApp account will return a 470 error

v2.45, January 10, 2023

Starting in v2.45, the optional cert parameter in the shards node will become mandatory for all requests. Please update your integration to always include a valid cert when calling the shards node Starting in v2.41.2, businesses can use the application node to filter out sent message statuses they are not interested in through the message object within the webhooks object. In v2.45, sent_status will be deprecated, so update your integration to use the webhooks object in the application node for all webhook controls As of v2.39.1, recipient_id is available in both the statuses object and in the message object. In v2.45, recipient_id will be removed in the statuses object, so update your integration to use recipient_id under the message object

October 6, 2022

Webhook Subscriptions

Message Templates

Cloud API

You can now use different callback URLs for each of your WhatsApp Business Accounts without having to create a unique app for each WhatsApp Business Account. See Overriding the Callback URL for details. All Cloud API endpoints now support version 15 calls. Text parameters (components.parameters.text) for message templates that only use a body component (components.type:body) can now total up to 32,768 characters. See Parameters object. Cloud API now supports up to 350 (up from 250) messages per second (mps) of combined text and media messages, by request. See Throughput for details. If you already have 250 mps it will be increased to 350 mps automatically. If you already requested 250 mps but the process has not been completed, you will receive 350 mps upon completion.

Embedded Signup

Embedded Signup now supports mobile web browsers. The user interface will automatically optimize for a mobile experience when it detects that the viewer is using a mobile web browser.

September 30, 2022

Embedded Signup

Businesses that have been onboarded by a Solution Partner through the Embedded Signup or “On Behalf Of” process can now initiate up to 250 conversations with unique customers in a rolling 24-hour period, immediately.

September 22, 2022

Messages

WhatsApp Business Profile

Cloud API

Reactions are now supported. See Send Messages - Reaction Messages to learn how to send and receive reactions and Payload Examples - Reaction Messages for webhook payload notification examples. The about field on business profiles is now supported. See Business Profiles for details.

September 19, 2022

On-Premises API

v2.41.3

The v2.41.3 version of our Business API client added a new table index on message_receipt_log that could benefit partners with high throughput needs. For instance, this improvement allows partners to send more than 200 messages/second.

September 7, 2022

Cloud API

Latest documentation for requesting migration from 80 messages per second to 250 messages per second of combined sending and receiving of text and media messages is now available. See Throughput.

August 25, 2022

Messages

Cloud API

You can now include animated stickers in outbound, business-initiated messages and receive message webhooks describing those messages the same way you would if you were sending a non-animated sticker. Refer to the Message object’s sticker property and for animated sticker asset requirements. You can now include products and services in messages sent to customers, and customers can add them to shopping carts without having to leave the chat thread. Refer to the Share Products guide to learn how to send Single and Multi-Product messages to customers.

July 21, 2022

Messages

Cloud API

Businesses can now reply to any message in a conversation thread. Replies will include a contextual bubble referencing the replied-to message. Refer to the Send Messages guide to learn how to reply to a message. Cloud API now supports up to 250 messages per second of combined sending and receiving (inclusive of text and media messages), by request. If you are an enterprise partner you can open a Direct Support⁠ ticket to request 250 MPS throughput by selecting Question Topic: “Cloud API Issues”, Request Type: “Request to migrate to 250 MPS throughput” and filling out the required information.

June 27, 2022

Webhook Subscriptions

Message Templates

On-Premises API

Best practices for a seamless upgrade to v2.41.2

In v2.41.2, we are introducing DB schema changes to improve the performance of the system. As a result, upgrades from v2.37.2 and v2.39.x for set ups with large databases which have millions of message and contact entries will take longer than usual.

Generally, perform upgrades during off-peak hours and upgrade lower-throughput setups first.

For large databases, follow these steps:

Run garbage collection via the /services/message/gc endpoint before your upgrade, and ensure it completes successfully Please use the dbupgrade tool to upgrade the DB schemas prior to the version upgrade.

Once done, you will be able to upgrade API versions with minimal down time. It is strongly recommended to bring the API client down before using the dbupgrade tool.

Ensure the dbupgrade tool completes successfully (exit code 0), and avoid or limit API requests while the upgrade is taking place.

We recommend increasing the query timeout on your database servers to one hour, until the upgrade completes successfully.

v2.41.2 features and updates

Improvements to the latency of the bulk /contacts endpoint requests and resolution of deadlock issues. Improvements to the performance and reliability of the garbage collection process. Businesses now have the ability to enable/disable delivered and read webhook notifications which gives them greater control over webhook notifications for messages. This can be achieved through the settings/applications endpoint. namespace field is optional for the template object. More robust handling of media download errors so businesses should experience less issues downloading media sent by customers. Additional reliability and bug fixes within the send message and registration workflows.

May 19, 2022

Message Templates

Cloud API

Starting today, the WhatsApp Business Cloud API is open to all developers building products or services for themselves or their organizations. To get started, see our guide. If you are interested in offering API access to your customers, please join our waitlist⁠.

Business Management API

The following values for the category parameter for the /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template endpoint have been deprecated for v14.0 and later:

ACCOUNT_UPDATEALERT_UPDATEAPPOINTMENT_UPDATEAUTO_REPLY

ISSUE_RESOLUTIONPAYMENT_UPDATEPERSONAL_FINANCE_UPDATERESERVATION_UPDATE

SHIPPING_UPDATETICKET_UPDATETRANSPORTATION_UPDATE

The following values have been added:

TRANSACTIONALMARKETING

May 10, 2022

On-Premises API

v2.39.4

This client version contains all features and fixes shipped with v2.39.1. Additionally, this release:

Fixes a bug that prevented video messages from being sent under certain circumstances. This fix was also included in v2.39.2. Fixes a bug that prevented businesses from sending messages to a customer, if the customer was the first to initiate an interaction between the two parties on WhatsApp, and that initiation happened more than 7 days ago. This fix was also included in v2.39.3. Fixes a bug that prevented businesses from receiving disappearing messages from customers. After v2.39.4 is installed, businesses will get notified they received a disappearing message by a webhooks notification with type set to "ephemeral". Businesses will not be able to see the message’s content.

When we launched v2.39.3, the disappearing messages issue was handled by WhatsApp automatically disabling these messages in the chat thread with the client. For v2.39.4, we will not do that. With this version, businesses that receive disappearing messages must ask the customer to disable disappearing messages and resend their latest message.

May 4, 2022

On-Premises API

v2.3.8

AWS Service Templates and Template URLs:

Enterprise: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa\_ent.yml?versionId=0pACuWHFUL7U1RjxGcTkAsza7rj.\_5tK DB: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa\_ent\_db.yml?versionId=4BtYzof0\_z0yl7Pbat9mln8Xj5CYS07Z Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa\_ent\_lambda.yml?versionId=o1JUcpuOHKfTU\_hRExFxhib5YCeXeZx. Network: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa\_ent\_net.yml?versionId=\_D2yaFcS1zEqRLf23t2Wesnh3M.Qw1UF Monitoring: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa\_ent\_monitoring.yml?versionId=H534ejFNiHnMpWyy1ERh3kr9TvM5VtyS

Changelog:

Updating AMIs for CentOS 7 machines

May 3, 2022

Cloud API

Fixed an issue related to disappearing messages from users. Better determination of thumbnail quality for media messages.

April 26, 2022

On-Premises API

v2.3.7

AWS Service Templates and Template URLs

Enterprise: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa\_ent.yml?versionId=bNECfwPYZZNGlhzkfCyheoQugydIiui4 DB: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa\_ent\_db.yml?versionId=RRa0vGtuodHnWNyww8uLyZUAWFOfQ7hN Lambda: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa\_ent\_lambda.yml?versionId=Sp2BO2LgxkVWH2XTxZ6pgOx3yf1xEqUQ Network: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa\_ent\_net.yml?versionId=uNubDzGLs1WddCGB0EgEa6OMSF1vw4Mn Monitoring: https://wa-biz-cfn.s3-us-west-2.amazonaws.com/wa\_ent\_monitoring.yml?versionId=HyC5PA5IZy9d.CFDkNTGDBEyxSHf5gHI

Changelog:

Moved from using pip to pip3 to install AWS bootstrap scripts. Fixed an issue with awscli installation.

April 14, 2022

Embedded Signup

We’re making it easier for businesses and partners to scale on the WhatsApp Business Platform with an improved onboarding experience. Starting May 2, 2022, businesses will be able to message customers immediately after signup and only need to complete Business Verification when they’re ready to scale business-initiated conversations or request to become an Official Business Account.

The changes mean that onboarded businesses will be able to:

Respond to unlimited customer-initiated conversations. Send business-initiated conversations to 50 unique customers in a rolling 24-hour period.

These are the changes being implemented on May 2, 2022:

WhatsApp Account checks and display name review will no longer be a requirement to get started on the platform. After signup, a compliance check with the WhatsApp Platform Policy Checks will be auto-triggered and will be performed in the background. Display name review will be initiated after Business Verification is completed. Businesses should still follow the display name best practice guidelines when adding a new phone number. For more information, see Display Names. Business Verification only needs to be completed when businesses are ready to scale business-initiated conversations or request to become an Official Business Account (OBA). For more information, see how to increase limits. Since businesses get access to sending messages after sign up, the Unverified Trial Experience will be deprecated. Businesses will be able to see the messaging limits in the Overview Dashboard in WhatsApp Manager -after completing the signup process.

The changes listed above have no impact on pricing. See pricing for more details.

April 5, 2022

Phone Number Verification

Messages

Webhook Subscriptions

Phone Number Registration

Cloud API

Starting today, the Cloud API is generally available to all existing Solution Partners and direct clients. Additionally, we’re releasing the following features for Cloud API developers:

Messages with Stickers: Send media messages containing third-party static stickers. See the following documentation for more details: Reference, Messages and Reference, Media. We support inbound both and outbound stickers. For outbound, we only support static third-party stickers. For inbound, we support all types of stickers. Deregister Phone Number API: Make POST calls to PHONE_NUMBER_ID/deregister in order to remove a phone number from the WhatsApp Business API. See Registration for information. New Phone Verification Option: Verify your business phone number via Graph API calls. See Phone Numbers for information. New Referral Webhooks: Receive Webhooks notifications when a user clicks on an ad that clicks to WhatsApp and sends a message to the business. See Webhooks for information. Be aware that the Cloud API’s webhooks referral object is different from the On-Premises API’s referral object.

Additionally, we are announcing that App Review is no longer required for first-party developers using the Cloud API. All developers are subject to the WhatsApp Business Platform messaging limits.

March 26, 2022

On-Premises API

v2.37.2

This version contains the same features as v2.37.1, but there’s a different expiration date. v2.37.2 expires on Sep 22, 2022.

Known Issues:

Some Kubernetes developers may see CrashLoopBackOff for their webapp container and their container may fail to start. To fix that, add following line in the Kubernetes deployment YML file under webapp configuration:

command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]

March 25, 2022

Webhook Subscriptions

On-Premises API

v2.39.3

The v2.39.3 version of our Business API client is available for developers today. The new client includes two fixes and additional logs to support debugging. The two fixes are:

Fixed a bug that prevented businesses from sending messages to a customer, if the customer was the first to initiate an interaction between the two parties on WhatsApp, and that initiation happened more than 7 days ago. Fixed a bug that prevented businesses from receiving disappearing messages from customers. After v2.39.3 is installed, businesses will get notified they received a disappearing message by a webhooks notification. On their end, customers will see a warning saying that the disappearing messages mode has been turned off.

March 15, 2022

Messages

Webhook Subscriptions

Cloud API

List Messages and Reply Buttons

Starting today, Cloud API beta users can start sending and list and reply button messages. See the following documentation for more details:

Reference, Messages Webhooks: List Messages and Reply Button Webhooks, Components

Preview URL

Starting today, Cloud API beta users can add a preview URL box to text messages that include a URL. See the following documentation for more details:

Reference, Messages

New Documentation Guides

Migrate Between On-Premises and Cloud API

March 4, 2022

On-Premises API

v2.39.2

We just released the On-Premises API v2.39.2. This version fixes a bug that prevented video messages from being sent under certain circumstances.

Known Issues:

A bug exists that prevents businesses from sending messages to a customer, if the customer was the first to initiate an interaction between the two parties on WhatsApp, and that initiation happened more than 7 days ago. A bug exists that prevents businesses from receiving disappearing messages from customers.

March 1, 2022

Messages

Webhook Subscriptions

Cloud API

Cloud API beta users can start sending and receiving video messages. The following documentation provides more information:

Media, Upload Media Supported Media Types Messages, Examples, Media Messages Webhooks, Components

February 1, 2022

Messages

Cloud API

Starting today, WhatsApp has switched from a notification-based pricing model to a conversation-based pricing model. Businesses are charged per conversation, which includes all messages delivered in a 24 hour session. See Conversation-Based Pricing for information.

Starting today, Cloud API beta users can start sending and receiving location and contact messages. See the documentation below for more information: Reference, Messages: Location and Contacts Webhooks, Examples: Received Messages We now support 80 messages per second peak throughput per phone number. This includes incoming and outgoing messages, as well as text, template and media messages.

On-Premises API

v2.39.1

The 2.39.1 version of our Business API client is available for developers starting today. The new client includes:

New field for the Set Shards API. New hostname added to network requirements. New error code 1031. Deprecations of the hsm type and the webhook_payload_conversation_pricingmodel_disabled application setting.

Set Shards API

Starting with the new API client version, you may provide your phone’s certificate when you are setting up multiconnect. That means that, when calling the /v1/account/shards endpoint, you can add the Base64-encoded certificate in the cert field. See Scale Your API Client With Multiconnect for information.

New Hostname

We have added graph.whatsapp.com to the list of WhatsApp server hostnames that the Business API client requires connectivity to. See Set Up and Debug Your Network, Hostnames for information.

Error Code Updates

With v2.39, we have added error code 1031. You will get this error if your account has been locked and can’t send any messages due to an integrity policy violation. See Error and Status Messages and Policy Enforcement for information.

Deprecations

Messages API: The hsm type has been deprecated with v2.39. You should use the template type instead. Application Setting: The application setting webhook_payload_conversation_pricingmodel_disabled has been deprecated.

Known Issues

Some video messages fail to send under certain circumstances.

November 15, 2021

Messages

Webhook Subscriptions

Cloud API

Audio Messages

Starting today, Cloud API beta users can start sending audio messages to their customers. For supported audio types, see our media documentation.

Webhooks

We have updated our webhooks documentation to clarify the following: if you receive a message type that is not yet supported by Cloud API, you will be notified via an unknown message webhook. This means that, for the current API beta release, you will get an unknown message webhook if you receive any of the following message types: Media Messages (Video), Contact Messages, Location Messages, Stickers, Stickerpacks.

October 21, 2021

Cloud API

Feature Availability

We have updated the list of features that will be available for the Cloud API Beta release. This is an updated snapshot of the features and their availability:

Available for beta:

Text Messages Text-Based Message Templates Media Messages (Images and Documents) Media-Based Message Templates (Images and Documents) Interactive Message Templates

Not available for beta:

Media Messages (Audio and Video) Media-Based Message Templates (Audio and Video) Contact Messages Location Messages Stickers and Stickerpacks List Messages Dynamic Reply Buttons Multi-Product Messages

Endpoint Availability:

The following endpoints will not be available for the Cloud API Beta release:

/PHONE_NUMBER_ID/deregister/PHONE_NUMBER_ID/application_settings

Staged Onboarding:

We’ve added specific instructions for each stage of the beta implementation. See more information here.

Migrating Between On-Premises and Cloud API:

We’ve added instructions to migrate from the Cloud API back to On-Premises, if needed. See more information here.

Filter

Call Permissions

Business Encryption

Multi-Partner Solutions

Calls

Phone Numbers

Official Business Account

WhatsApp Business Account On-Behalf Requests

Message Templates

Phone Number Registration

WhatsApp Business Account

WhatsApp Business Account Users

Conversational Automation

Solution Migration

Marketing Messages

Webhook Subscriptions

WhatsApp Business Profile

Messages

Pre-Verified Phone Numbers

MM Lite Onboarding

Phone Number Management

Phone Number Verification

Pre-Verified Phone Number Sharing

Application

Page

Post

User

Page

App

Object

User

Whats App Business Account

Getting Started

Timezone Ids

Custom Conversion

Extended Credit Invoice Group

Product Feed Upload

Product Item

Messaging Api

Ig Media

Ig User

Instagram Media

Guides

Guides

Guides

Guides

Getting Started

Rejection Guides

Class

App Review

Current

Developer Platform ​

WhatsApp Flows Endpoints Security Enhancements (Data API Version 4.0) ​

What Does This Mean for Businesses? ​

Flow JSON Validation Updates ​

Validation for routing model and data model in Flow JSON ​

Component updates ​

Validation for nested expressions in Flow JSON actions ​

Component Updates ​

Update to the ChipsSelector component ​

Image Carousel component ​

Message template updates ​

Flows can now be sent with other buttons in message templates ​

Developer Platform

WhatsApp Flows Endpoints Security Enhancements (Data API Version 4.0)

What Does This Mean for Businesses?

Flow JSON Validation Updates

Validation for routing model and data model in Flow JSON

Component updates

Validation for nested expressions in Flow JSON actions

Component Updates

Update to the ChipsSelector component

Image Carousel component

Message template updates

Flows can now be sent with other buttons in message templates