WhatsApp Business Platform
WhatsApp Business Platform
Resources
Changelog
Updated: Apr 16, 2026
Get notified
Changelog (186)
Apr 16, 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.
Apr 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.
Apr 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.
Apr 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.
Mar 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.
Mar 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).
Feb 19, 2026

Marketing Messages API for WhatsApp
Added a new Automatic Creative Optimization type: Auto promotion tag.
Feb 19, 2026

Cloud API
Added new unsupported message types in the unsupported messages webhook.
Feb 4, 2026

Embedded Signup
Added account_offboarded and account_reconnected webhooks for Coexistence.
Feb 3, 2026

Cloud API
Cloud API Groups are now available to all businesses with an Official Business Account.
Jan 29, 2026

Marketing Messages API for WhatsApp
Multi-solution conversations are now available for Marketing Messages API for WhatsApp.
Jan 28, 2026

Cloud API
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.
Dec 8, 2025

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.
Dec 4, 2025

Marketing Messages API for WhatsApp
Businesses that use Marketing Messages API for WhatsApp can now view metrics for quick replies.
Dec 3, 2025

Cloud API
Coupon code templates now support codes with up to 20 characters, instead of 15.
Dec 1, 2025

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.
Nov 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
Nov 25, 2025

Embedded Signup
The following messages event webhooks are now supported for Coexistence in Embedded Signup:
Nov 19, 2025

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

Cloud API
Nov 3, 2025

Cloud API
Updated the unsupported message webhookby 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.
Oct 31, 2025

MM Lite API
Oct 23, 2025

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)
Oct 20, 2025

MM Lite API
Oct 20, 2025

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.
Oct 17, 2025

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.
Oct 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:
Oct 16, 2025

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:
Oct 14, 2025

MM Lite API
The product_policy field is now 100% rolled out for businesses customers.
Oct 8, 2025

Cloud API, Business Management API
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).
Oct 8, 2025

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). For more information, see the versions and v4 page.
MM Lite
Updated the onboarding page with an onboarding video tutorial.
Oct 6, 2025

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

Solution providers
Access verification is no longer required to become a Tech Provider.
Oct 1, 2025

Cloud API, Marketing Messages Lite API, Pricing
  • 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.
Oct 1, 2025

MM Lite API
Updated the support page with new troubleshooting guides.
Sep 29, 2025

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.
Sep 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.
Sep 8, 2025

Cloud API
Sep 3, 2025

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.
Aug 27, 2025

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.
Aug 22, 2025

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.
Aug 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.
Aug 12, 2025

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.
Aug 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.
Aug 6, 2025

MM Lite API
Added a image background generation field for automatic creative optimization.
Aug 4, 2025

Cloud API
Added new whatsapp_business_manage_events permission to log events.
Jul 30, 2025

Cloud API
Changed the Media Card Carousel Template requirements so that card body text is no longer mandatory.
Jul 25, 2025

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.
Jul 25, 2025

Cloud API
Added the Tap target title URL override message template.
Jul 22, 2025

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.
Jul 16, 2025

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.
Jul 15, 2025

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.
Jul 15, 2025

Cloud API
WhatsApp Business Platform
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.
Jul 7, 2025

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.
Jul 1, 2025

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

Cloud API
Per-message pricing is now live.
Jun 24, 2025

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.
Jun 20, 2025

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.
Jun 18, 2025

Embedded Signup
Jun 13, 2025

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.
Jun 10, 2025

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_benchmark
  • marketing_messages_click_rate_benchmark
Jun 5, 2025

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.
Jun 4, 2025

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

MM Lite API
Added Android deep link support.
May 21, 2025

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

MM Lite API
Added new error codes to help diagnose messaging errors. These will be available with Graph API version 23.0.
  • 134100
  • 134101
  • 134102
  • 134103
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.
Apr 16, 2025

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

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.
Apr 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.
Apr 8, 2025

Cloud API
Added typing indicators so you can let WhatsApp users know that you are preparing a response.
Apr 2, 2025

WhatsApp Manager
Added ability to create and share WhatsApp Business Accounts using WhatsApp Manager.
Apr 1, 2025

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.
Apr 1, 2025

Pricing
Lowered authentication-international pricing rates for Egypt, Nigeria, Pakistan, and South Africa.
Mar 31, 2025

Cloud API, On-Premises API
Payments API for business portfolios with Singapore addresses is no longer available.
Mar 27, 2025

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.
Mar 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.
Feb 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:
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.
Feb 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.
Feb 11, 2025

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

Pricing
Jan 23, 2025

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

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

Multi-Partner Solutions
Dec 10, 2024

Embedded Signup
Added Sandbox accounts for easier testing of the Embedded Signup flow.
Dec 1, 2024

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

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.
Nov 18, 2024

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.
Nov 18, 2024

Cloud API
Nov 15, 2024

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:
  1. 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).
  2. 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.
  3. 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.
  4. 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.
Nov 13, 2024

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.
Nov 12, 2024

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.
Nov 8, 2024

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.
Nov 5, 2024
Nov 1, 2024

Cloud API, Pricing
Service conversations are now free for all businesses, including via AI-enabled conversational experiences.
Nov 1, 2024

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:
  1. Ads Manager UI [recommended]
  2. Marketing API “Insights API” [recommended]
  3. WhatsApp Manager UI “WABA Insights” page and “Template Insights” page
  4. Business Management API
  5. 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.
Oct 30, 2024

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.
Oct 15, 2024

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.
Oct 2, 2024

Cloud API
Oct 1, 2024

Cloud API, Pricing
Updated pricing rates in India, Saudi Arabia, the United Arab Emirates, and the United Kingdom.
Sep 25, 2024

Cloud API
Changed steps in the App Dashboard to make it easier to become a Tech Provider.
Sep 24, 2024

Cloud API
Added checkout button templates (only available to India businesses that use business phone numbers with India country calling codes).
Sep 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.
Sep 6, 2024

Cloud API
Aug 1, 2024

Cloud API, Pricing
Lowered utility conversation pricing rates.
Jun 25, 2024

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

Cloud API
Business Management API
  • Added automatic category updates to correct templates that are miscategorized according to our guidelines.
Mar 18, 2024

Cloud API
Feb 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).
Feb 6, 2024

Cloud API, On-Premises API
Jan 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.
Jan 18, 2024
Dec 18, 2023
Dec 12, 2023

Business Management API
Nov 20, 2023

Business Management API
  • Added console logging to help with debugging one-tap and zero-tap authentication templates.
Nov 14, 2023

Cloud API
Embedded Signup
Embedded Signup can now be used to migrate customer business phone numbers from one WhatsApp Business Account to another.
Nov 3, 2023

Business Management API
Oct 23, 2023

Business Management API, Cloud API, On-Premises API
Oct 10, 2023

Cloud API
Oct 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).
Oct 2, 2023

Cloud API
Sep 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.
Sep 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).
Sep 12, 2023

Business Management API
Cloud API
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.
Aug 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.
Aug 15, 2023

Business Management API
Aug 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.
Aug 8, 2023

Cloud API
Business Management API
Embedded Signup
Aug 2, 2023

Business Management API
Pre-verified business phone numbers now have a VERIFIED status of 28 days (up from 14).
Jul 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.
Jul 7, 2023

Business Management API
Authentication template copy code button text and autofill button text are now optional upon creation.
Jul 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.
Jun 13, 2023

Cloud API
Business Management API
Added Business Management API error code 2494100 that indicates a business phone number is temporarily in maintenance mode.
Cloud API
May 26, 2023

Cloud API
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
Cloud API
On-Premises API
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.
Apr 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).
Apr 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.
Apr 17, 2023

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.
Apr 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
Apr 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.
Mar 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.
Mar 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.
Mar 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.
Feb 15, 2023

Business Management API
Added a new template comparison endpoint that allows you to compare template send counts and block ratios.
Feb 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.
Feb 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": <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 message
    • 130429 new title is now Rate limit hit
    • 131045 new title is now Incorrect certificate
    • 131031 new title is now Business Account locked
    • 131053 new title is now Media upload error
    • 131027 new title is now Something went wrong
    • 131042 new title is now Business eligibility payment issue
    • 131026 new title is now Message Undeliverable
    • 131000 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.errors
  • entry.changes.value.messages.errors
  • entry.changes.value.statuses.errors
Jan 30, 2023

Cloud API
Unverified businesses can now initiate up to 250 conversations in a rolling 24-hour period.
Jan 10, 2023

Embedded Signup
We have started rolling out the new embedded signup UI.
Dec 13, 2022

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.
Dec 8, 2022

Cloud API
Nov 23, 2022

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.
Nov 22, 2022

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:
Sample Webhooks notifications that are sent when these new events are triggered:
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_account
  • messaging_limit_tier
In addition, you can filter WhatsApp Business Account Phone Numbers endpoint by is_official_business_account.
Applies to v15.0 and newer.
Nov 3, 2022

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.
Oct 25, 2022

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.
Oct 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.
Oct 12, 2022

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.
Oct 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
Oct 6, 2022

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.
Sep 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.
Sep 22, 2022

Cloud API
Sep 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.
Sep 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.
Aug 25, 2022

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.
Jul 21, 2022

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.
Jun 27, 2022

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

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_UPDATE
  • ALERT_UPDATE
  • APPOINTMENT_UPDATE
  • AUTO_REPLY
  • ISSUE_RESOLUTION
  • PAYMENT_UPDATE
  • PERSONAL_FINANCE_UPDATE
  • RESERVATION_UPDATE
  • SHIPPING_UPDATE
  • TICKET_UPDATE
  • TRANSPORTATION_UPDATE
The following values have been added:
  • TRANSACTIONAL
  • MARKETING
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 3, 2022

Cloud API
  • Fixed an issue related to disappearing messages from users.
  • Better determination of thumbnail quality for media messages.
Apr 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.
Apr 5, 2022

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.
Mar 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"]
Mar 25, 2022

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.
Mar 15, 2022

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:
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:
New Documentation Guides
Mar 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.
Mar 1, 2022

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

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:
  • 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.
Nov 15, 2021

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