Changelog

This document is a log of changes to the WhatsApp Business Platform.

June 4, 2025

Business Management API

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

May 29, 2025

Cloud API

Added error code 132018 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 5, 2025

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

Cloud API

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

April 2, 2025

WhatsApp Manager

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

April 1, 2025

Pricing

March 31, 2025

Cloud API, On-Premises API

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

March 20, 2025

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.

February 27, 2025

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

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 //template_groups
• Added POST //template_groups
• Added GET //template_group_analytics
• Added GET /
• Added POST /
• Added DELETE /

February 11, 2025

Embedded Signup

Added ability for solution providers to onboard WhatsApp Business app users via Embedded Signup.

February 1, 2025

Pricing

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 7, 2025

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 //set_solution_migration_intent endpoint to allow for migration off of Multi-Partner Solutions.

December 10, 2024

Embedded Signup

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

November 18, 2024

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 13, 2024

Cloud API

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

November 12, 2024

Cloud API

Added POST //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 5, 2024

All APIs

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

November 1, 2024

Pricing

October 11, 2024

Business Management API

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

October 2, 2024

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 //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 //settings endpoint, which can be used to enable or disable local storage.
  • Removed the data_localization_region parameter from the POST //register endpoint.

October 1, 2024

Pricing

September 25, 2024

Cloud API

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

September 24, 2024

Cloud API

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

September 11, 2024

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

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 1, 2024

Pricing

June 1, 2024

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.

April 10, 2024

Cloud API

• Added Utility Template Library

April 10, 2024

Cloud API

• Added webook callback URL override on business phone numbers.

March 18, 2024

Cloud API

• Added the Conversational Components API.

February 13, 2024

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

Cloud API, On-Premises API

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

January 26, 2024

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

Cloud API

• Added Conversational Components.

December 18, 2023

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.

November 20, 2023

Business Management API

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

November 14, 2023

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

Business Management API

• Carousel template creation now requires at least one button.

October 23, 2023

Business Management API, Cloud API, On-Premises API

• Added zero-tap authentication messages.

October 10, 2023

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

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

Cloud API

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

September 27, 2023

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

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

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

Cloud API, On-Premises API

• Added template pacing (beta, for select countries).

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

Tools

• 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

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

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

Tools

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

Tools

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

May 23, 2023

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

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

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

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

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

Business Management API

Added last_onboarded_time field to the GET / and GET /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

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

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

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

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

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

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.
  • AUTHENTICATION
  • MARKETING
  • UTILITY
• 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": ,
    "title" : "