# Marketing Messages

# Marketing Messages API for WhatsApp | Developer Documentation

<div id="bkmrk-marketing-messages-a">## Marketing Messages API for WhatsApp

<div><span>Updated: Feb 10, 2026</span></div><div><span><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></span></div><div>MM API for WhatsApp is our next-generation marketing solution built to enhance the customer experience and deliver the right message to more of the right people.</div><div id="bkmrk-key-benefits"><div id="bkmrk-key-benefits-1"><div>#### Key benefits

</div></div></div><span>1. **Boost and measure business results**: With our automatic delivery optimizations, you can reach more of the people who will find your messages valuable and may drive more reads and clicks. You can also access exclusive measurement insights: <span>
    1. *Performance benchmarks*, to understand how your message performed compared to similar businesses
    </span><span>
    1. *Tailored recommendations*, to improve campaign performance
    </span>
</span><span>1. **Enhance customer experience and engagement**: MM API for WhatsApp helps deliver more relevant and timely marketing messages to customers with exclusive features like: <span>
    1. Automatic creative optimizations (in testing), to apply creative treatments like image animation and filtering for more engaging messages.
    </span><span>
    1. Richer media formats, like GIFs.
    </span><span>
    1. Time-to-live, to avoid irrelevant or delayed message delivery for time-sensitive campaigns.
    </span>
</span><span>1. **Upgrade easily, with consistent reliability and security**: MM API for WhatsApp is easy-to-use, reliable, and secure. It offers a similar technical schema and same billing model as Cloud API, and businesses can use existing phone numbers and MM templates.
</span>
<div>Send all your marketing traffic to the `/marketing_messages` endpoint for automatic routing of eligible business’ messages.</div><div id="bkmrk-footnotes"><div id="bkmrk-footnotes-1"><div>### Footnotes

</div></div></div><span>1. \*An AB test was conducted with approximately 12 million delivered marketing messages sent by advertisers in India between January 1, 2025, and January 31, 2025. The test compared MM API for WhatsApp optimized delivery to standard Cloud API delivery for high engagement messages only (For example, messages with more reads, clicks, etc.) and the analysis consisted of a t-test at a 95% confidence level.
</span>
</div>

# Get started | Developer Documentation

<div id="bkmrk-get-startedupdated%3A-">## Get started

<div><span>Updated: Feb 10, 2026</span></div><div><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></div><div>Learn how to send a template message with the Marketing Messages API for WhatsApp (MM API for WhatsApp).</div><div id="bkmrk-requirements"><div id="bkmrk-requirements-1"><div>### Requirements

</div></div></div><span>You have an active WhatsApp Business Account and are in a [country eligible for MM API for WhatsApp](/books/meta-whatsapp/page/get-started-developer-documentation).</span><span>You have an approved [marketing template message](/books/meta-whatsapp/page/marketing-templates-developer-documentation).</span><span>You are subscribed to the [messages](/books/meta-whatsapp/page/messages-webhook-reference-developer-documentation) webhook.</span><div id="bkmrk-step-1%3A-accept-terms"><div id="bkmrk-step-1%3A-accept-terms-1"><div>### Step 1: Accept Terms of Service

</div></div></div><span>Navigate to the [**App Dashboard**](https://developers.facebook.com/apps) &gt; **WhatsApp** &gt; **Quickstart** panel.</span><span>Locate the “**Improve ROI with marketing messages with optimizations**” module and click the “**Get started**” button.</span><span>Click on “**Continue to integration guide**” and accept the Terms of Service.</span><div id="bkmrk-step-3%3A-verify-messa"><div id="bkmrk-step-3%3A-verify-messa-1"><div>### Step 3: Verify message was sent through the `status` webhook

</div></div></div><div id="bkmrk-geographic-availabil"><div id="bkmrk-geographic-availabil-1"><div>### Geographic availability of features

</div></div></div><div>Some advanced features and reporting capabilities of MM API for WhatsApp are available only in particular geographies due to Meta policy and/or local regulation.</div><div id="bkmrk-european-economic-ar"><div id="bkmrk-european-economic-ar-1"><div>#### European Economic Area, United Kingdom, Japan, South Korea

</div></div></div><span>Messages sent from a business phone number in these countries, or to a consumer in these countries, will not receive delivery optimizations. **Note** that [per-user marketing message template limits](/books/meta-whatsapp/page/per-user-marketing-template-message-limits-developer-documentation) are also not active in these countries, so a lack of delivery optimizations will not have any effect on message delivery.</span><span>Messages sent from a business phone number in these countries, or to a consumer in these countries, will not have click and conversion reporting metrics available.</span><span>For businesses in these countries, metrics are not available on Ads Manager UI or Insights API. As with Cloud API, metrics will be available via Business Management API and WhatsApp Manager UI ‘conversation’ metrics.</span><div id="bkmrk-united-states"><div id="bkmrk-united-states-1"><div>#### United States

</div></div></div><span>Starting April 1, 2025, marketing messages sent to WhatsApp users in the United States will not be delivered (error code 131049). Note that this policy is not specific to MM API for WhatsApp - it is in place across all Business Messaging APIs (including Cloud API, [see docs](/books/meta-whatsapp/page/per-user-marketing-template-message-limits-developer-documentation)).</span><span>Businesses phone numbers in the US will continue to be able to use MM API for WhatsApp to message users outside of the United States.</span><div id="bkmrk-cuba%2C-iran%2C-north-ko"><div id="bkmrk-cuba%2C-iran%2C-north-ko-1"><div>#### Cuba, Iran, North Korea, Syria, and three sanctioned regions in the Ukraine (Crimea, Donetsk, Luhansk):

</div></div></div><span>Businesses in these regions are not eligible to onboard, and messages cannot be sent to a consumer in these regions. This policy is not specific to MM API for WhatsApp - it is in place across all Business Messaging APIs (including Cloud API, [see docs](/books/meta-whatsapp/page/faqs-developer-documentation)).</span><div id="bkmrk-russia"><div id="bkmrk-russia-1"><div>#### Russia

</div></div></div><div>Starting June 20, 2025, businesses in Russia will be able to use MM API for WhatsApp with the following feature exceptions:</div><span>Messages sent by a business with a Meta business profile in Russia, or using a payment method with a Russian address, will not receive delivery optimizations.</span><span>Messages sent from a business phone number in these countries, or to a consumer in these countries, will not have click and conversion reporting metrics available. For businesses in these countries, metrics are not available on Ads Manager UI or Insights API. As with Cloud API, metrics will continue to be available via Business Management API and WhatsApp Manager UI conversation metrics.</span><span>All other features of MM API for WhatsApp continue to be available.</span><div id="bkmrk-learn-more"><div id="bkmrk-learn-more-1"><div>### Learn more

</div></div></div><span>Learn about additional [marketing message formats](/books/meta-whatsapp/page/marketing-templates-developer-documentation)</span></div>

# Features | Developer Documentation

<div id="bkmrk-featuresupdated%3A-feb">## Features

<div><span>Updated: Feb 10, 2026</span></div><div><span></span><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></div><div>Marketing Messages API for WhatsApp offers added features that are not available on Cloud API, such as performance benchmarks and recommendations, time-to-live, and automated creative optimizations (in testing).</div><div>For more detail, see the comparison tables below.</div><div id="bkmrk-optimization-feature"><div id="bkmrk-optimization-feature-1"><div>### Optimization features

</div></div></div><div><table><thead><tr><th><span>Description </span></th><th><span>Marketing Messages API for WhatsApp (Supports Marketing) </span></th><th><span>Cloud API (Supports Auth, Utility, Service, Marketing) </span></th></tr></thead><tbody><tr><td><div><div>**Quality-based delivery:** Improving deliveries of high engagement messages.</div></div></td><td><div><div>**Yes:** Marketing Messages API for WhatsApp factors if a message is high engagement into delivery decisions, offering up to 9% higher deliveries vs. Cloud API (see footnote below). High engagement marketing messages refers to messages that are expected by users, relevant, and timely, and therefore more likely to be read and clicked.</div></div></td><td><div><div>**No:** Message quality does not factor into per-user marketing message limits. No ability to increase delivery for high engagement messages.</div></div></td></tr><tr><td><div><div>**Automated creative optimizations:** Automatic enhancements to creative to increase message performance.</div></div></td><td><div><div>**Yes (pilot):** Automatically enhance the visual appeal and engagement of marketing template messages. See full list of capabilities [here](/books/meta-whatsapp/page/send-marketing-messages-developer-documentation).</div></div></td><td><div><div>**No**</div></div></td></tr></tbody></table>

</div><div id="bkmrk-marketing-message-fo"><div id="bkmrk-marketing-message-fo-1"><div>### Marketing message formats

</div></div></div><div><table><thead><tr><th><span>Description </span></th><th><span>Marketing Messages API for WhatsApp (Supports Marketing) </span></th><th><span>Cloud API (Supports Auth, Utility, Service, Marketing) </span></th></tr></thead><tbody><tr><td><div><div>**Animated Image (GIF) Header:** Marketing message templates support a GIF [media type in the header](/books/meta-whatsapp/page/template-components-developer-documentation).</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**No**</div></div></td></tr><tr><td><div><div>**Android App Deep Links:** [Links](/books/meta-whatsapp/page/deep-links-developer-documentation) that directly open up the app on a customer’s phone.</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**No**</div></div></td></tr><tr><td><div><div>**Customizable Message Validity Periods:** Set a [time-to-live for messages](/books/meta-whatsapp/page/send-marketing-messages-developer-documentation) that should expire if they cannot be delivered soon enough.</div></div></td><td><div><div>**Yes:** TTL can range from 12 hours to 30 days.</div></div></td><td><div><div>**Limited:** Only supports Authentication and Utility messages.</div></div></td></tr><tr><td><div><div>**Basic marketing message formats:** [Media, carousel, product catalog, flow, interactive list, interactive reply, etc.](/books/meta-whatsapp/page/marketing-templates-developer-documentation)</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**Yes**</div></div></td></tr></tbody></table>

</div><div id="bkmrk-guidance"><div id="bkmrk-guidance-1"><div>### Guidance

</div></div></div><div><table><thead><tr><th><span>Description </span></th><th><span>Marketing Messages API for WhatsApp (Supports Marketing) </span></th><th><span>Cloud API (Supports Auth, Utility, Service, Marketing) </span></th></tr></thead><tbody><tr><td><div><div>**Benchmarks:** Comparison of read and click rates versus similar templates from businesses in your region.</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**No**</div></div></td></tr><tr><td><div><div>**Recommendations:** Evidence-based recommendations to improve the performance of your template.</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**No**</div></div></td></tr></tbody></table>

</div><div id="bkmrk-metrics"><div id="bkmrk-metrics-1"><div>### Metrics

</div></div></div><div><table><thead><tr><th><span>Description </span></th><th><span>Marketing Messages API for WhatsApp (Supports Marketing) </span></th><th><span>Cloud API (Supports Auth, Utility, Service, Marketing) </span></th></tr></thead><tbody><tr><td><div><div>**Conversion metrics:** Conversions on Web and App.</div></div></td><td><div><div>**Yes:** [Measure marketing messages](/books/meta-whatsapp/page/setting-up-conversion-measurement-developer-documentation) leading users to perform app events, such as “Add to Cart”, “Checkout Initiated”, and “Purchase”.</div></div></td><td><div><div>**No**</div></div></td></tr><tr><td><div><div>**Cost metrics:** [Spend per Template, Cost per click, Cost per delivery.](/books/meta-whatsapp/page/viewing-metrics-developer-documentation)</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**Yes**</div></div></td></tr><tr><td><div><div>**Basic metrics:** [Sent, delivered, read, clicked, errors.](/books/meta-whatsapp/page/viewing-metrics-developer-documentation)</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**Yes**</div></div></td></tr></tbody></table>

</div><div id="bkmrk-enterprise%2C-security"><div id="bkmrk-enterprise%2C-security-1"><div>### Enterprise, Security 5 &amp; Compliance Features

</div></div></div><div><table><thead><tr><th><span>Description </span></th><th><span>Marketing Messages API for WhatsApp (Supports Marketing) </span></th><th><span>Cloud API (Supports Auth, Utility, Service, Marketing) </span></th></tr></thead><tbody><tr><td><div><div>**Local Storage Support:** Phone numbers with [Local Storage enabled.](/books/meta-whatsapp/page/local-storage-developer-documentation)</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**Yes**</div></div></td></tr><tr><td><div><div>**Compliance certification:** Compliance resources available on the [Business Messaging Compliance Center<span>⁠</span>](https://www.facebook.com/business/business-messaging/compliance).</div></div></td><td><div><div>**Yes:** Certification for LGPD, GDPR, System Audit Report, SOC, ISO27001.</div></div></td><td><div><div>**Yes:** Certification for LGPD, GDPR, System Audit Report, SOC, ISO27001.</div></div></td></tr><tr><td><div><div>**Automatic throughput upgrades:** Automatic upgrades (and webhook notifications) to a phone number’s [messaging throughput](/books/meta-whatsapp/page/throughput-developer-documentation).</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**Yes**</div></div></td></tr><tr><td><div><div>**Real-time service status updates:** [Uptime and availability metrics](/documentation/business-messaging/whatsapp/support/api-status-page) are live on [metastatus.com<span>⁠</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Fmetastatus.com%2Fwhatsapp-business-api%3Ffbclid%3DIwY2xjawM2uLNleHRuA2FlbQIxMQBicmlkETFPWE5PUldSeE95a2tuMnA1AR4r-Af63nidsmVRDdEJ4WtriGpxdlenOA60_uzhuqXHr06lE0-d2S9pnJm_Ww_aem_WtrDEZEwN2EZflsD4vmusQ&h=AT76QDI6has-EB-CuH2jOsRXVyjN54_lh4YppOHo-KCDE-kwTG7tP12WNayzTeMYgG5YSKkZopUPH_SGdXFHzFS6tpDxNkk3pTvwpjVDUYPq--u2c42C4yWtPwGGmyGYD3Btd5YtajA1JoghZwqMBA).</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**Yes**</div></div></td></tr></tbody></table>

</div><div id="bkmrk-onboarding"><div id="bkmrk-onboarding-1"><div>### Onboarding

</div></div></div><div><table><thead><tr><th><span>Description </span></th><th><span>Marketing Messages API for WhatsApp (Supports Marketing) </span></th><th><span>Cloud API (Supports Auth, Utility, Service, Marketing) </span></th></tr></thead><tbody><tr><td><div><div>**Streamlined Onboarding:** [Onboard via Embedded Signup, Intent API, and Intent UI](/books/meta-whatsapp/page/onboard-developer-documentation).</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**Limited:** Embedded signup only.</div></div></td></tr><tr><td><div><div>**Error Codes:** Graph API [error codes](/documentation/business-messaging/whatsapp/support/error-codes#marketing-messages-api-for-whatsapp-error-codes).</div></div></td><td><div><div>**Yes:** [Specific Marketing Messages API for WhatsApp error codes](/documentation/business-messaging/whatsapp/support/error-codes#marketing-messages-api-for-whatsapp-error-codes).</div></div></td><td><div><div>**Yes**</div></div></td></tr><tr><td><div><div>**Onboarding Status via API:** Granular [eligibility status data and error codes](/documentation/business-messaging/whatsapp/marketing-messages/changelog#july-15--2025).</div></div></td><td><div><div>**Yes:** A [new eligibility status field](/books/meta-whatsapp/page/onboard-developer-documentation) has been introduced to better report on the API onboarding status.</div></div></td><td><div><div>**Limited**</div></div></td></tr><tr><td><div><div>**Coexistence:** [Onboarding WhatsApp business app users.](/books/meta-whatsapp/page/onboard-business-customers-developer-documentation)</div></div></td><td><div><div>**Yes**</div></div></td><td><div><div>**Yes**</div></div></td></tr></tbody></table>

</div><div id="bkmrk-footnote"><div id="bkmrk-footnote-1"><div>### Footnote

</div></div></div><div>The A/B test was conducted with ~12 million delivered marketing messages sent by advertisers in India between 1st Jan 2025 to 31st Jan 2025. It compared Marketing Messages API for WhatsApp optimized delivery to standard Cloud API delivery for high engagement messages only (that is to say, more reads, clicks, etc.) and the analysis consisted of a t-test at 95% confidence.</div></div>

# Onboard | Developer Documentation

<div id="bkmrk-onboardupdated%3A-feb-">## Onboard

<div><span>Updated: Feb 10, 2026</span></div><div><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></div><div>Onboarding to the Marketing Messages API for WhatsApp (MM API for WhatsApp) is a low-effort upgrade to sending marketing messages with optimizations on Cloud API. See the directions below to onboard your business, whether you integrate with the API directly or work with a partner.</div><div>When a business registers for the MM API for WhatsApp, read-only Ad accounts are created that are linked to each of the marketing templates that exist under their business portfolio.</div><div>These linked accounts allow a business to:</div><span>fetch their MM API for WhatsApp insights from the Marketing API “Insights API” to view the same</span><div>These read-only ad accounts are kept in sync with any changes to marketing templates, so that any changes to marketing templates are reflected in the linked ad entity.</div><div>Follow the steps below to Onboard to MM API for WhatsApp.</div><div id="bkmrk-eligibility-requirem"><div id="bkmrk-eligibility-requirem-1"><div>### Eligibility requirements

</div></div></div><div>In order to use the Marketing Messages API for WhatsApp (MM API for WhatsApp), a business must comply with applicable legal, vertical and content restrictions (country dependent) outlined in [WhatsApp Business Messaging Policies<span>⁠</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fpolicy&h=AT5NSg0c3v5O8rslKMZUp262bKaeD-F7CwUdyFnHjCP-Ips2yG_fjrB-EExkVgCOTTveomyPB2O1FM60dGr00I7NGGZhIPg-wg80bvWXUY_eu4fV7D_ejbySmOT__vNlAXbSMdT9-5Jy98K8F7nw3g).</div><div>In addition, the following requirements must be met:</div><span>WABA is active and not restricted from messaging due to any violations</span><span>WABA tax country is not in sanctioned regions</span><span>Owner Business country is not in sanctioned regions</span><div>MM API for WhatsApp will continuously update vertical eligibility and policies to comply with various policies and regulations internationally, so these requirements may change.</div><div id="bkmrk-checking-eligibility"><div id="bkmrk-checking-eligibility-1"><div>#### Checking eligibility status (alternative)

</div></div></div><div><div>This field will be deprecated in version 24.0. We recommend using the [`marketing_messages_onboarding_status` field](#bkmrk-check-waba-onboardin-1) instead.</div></div><div>For partner-managed WABAs, businesses can find eligible WABAs using the following endpoint:</div><div id="bkmrk-register-a-phone-num"><div id="bkmrk-register-a-phone-num-1"><div>### Register a phone number on Cloud API

</div></div></div><div>In order to send a message via MM API for WhatsApp, a business phone number must also be registered on Cloud API. MM API for WhatsApp and Cloud API are used together on the same phone number:</div><div>Cloud API allows a business to send Authentication, Service, Utility, and non-Optimized Marketing template messages and freeform messages, and receive inbound messages from consumers on a business phone number.</div><div>MM API for WhatsApp allows a business to send marketing messages with optimizations, over the same phone number as is registered on Cloud API.</div><div>WhatsApp Business phone numbers that are not registered on Cloud API cannot be used with MM API for WhatsApp.</div><div>If a business phone number is already registered on Cloud API, phone number verification is not required when registering for MM API for WhatsApp, as no new phone numbers are registered during the MM API for WhatsApp registration process. Existing Phone Numbers remain registered on Cloud API, and will now be eligible to use MM API for WhatsApp in addition to and simultaneously with Cloud API for sending marketing messages.</div><div id="bkmrk-for-solution-provide"><div id="bkmrk-for-solution-provide-1"><div>### For solution providers

</div></div></div><div>If you are a solution provider onboarding your end businesses, refer to [onboard business customers](/books/meta-whatsapp/page/onboard-business-customers-developer-documentation).</div><div id="bkmrk-onboarding-business-"><div id="bkmrk-onboarding-business--1"><div>### Onboarding business customers

</div></div></div><div>You can instruct your business customers to have someone with full control to the business portfolio to accept the Terms of Service and onboard MM API for WhatsApp via WhatsApp Manager.</div><span>Open WhatsApp Manager &gt; Overview.</span><span>In the Alerts section, click Accept terms to get started for Marketing Messages API for WhatsApp.</span><span>Follow the steps to finish signing MM API for WhatsApp Terms of Service.</span><div>Your business customers should be able to start sending messages via MM API for WhatsApp.</div><div>If you are unable to access your WhatsApp Manager, [find your business portfolio admin here](/books/meta-whatsapp/page/faqs-developer-documentation).</div><div id="bkmrk-for-business-custome"><div id="bkmrk-for-business-custome-1"><div>### For business customers without a partner

</div></div></div><div>If your business directly integrates with Cloud API without a partner, follow the instructions below to accept the Terms of Service and onboard to MM API for WhatsApp.</div><span>Navigate to the **[App Dashboard](/apps)** &gt; **WhatsApp** &gt; **Quickstart** panel.</span><span>On the **Quickstart** page, locate the “Improve ROI with Marketing Messages API for WhatsApp” card and click the “Get started” button.</span><span>Click on “Continue to integration guide” to accept the Terms of Service</span><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-abxxmkou.png)</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-il1ybkmj.png)</div><div id="bkmrk-receive-mm-api-for-w"><div id="bkmrk-receive-mm-api-for-w-1"><div>### Receive MM API for WhatsApp Terms of Service signed webhook (Preferred)

</div></div></div><div>Note: The ToS event value will be available from September 8th, 2025. Refer to the legacy webhook below.</div><div>When the MM API for WhatsApp Terms of Service (ToS) is signed for a business, a new [`account_update`](/documentation/business-messaging/whatsapp/webhooks/reference/account_update) webhook will be sent for each WhatsApp Business Account (WABA) under your business portfolio. The webhook indicates that the WABA’s business has successfully accepted the MM API for WhatsApp ToS. When the webhook is triggered, your WABA will be allowed to send messages through MM API for WhatsApp.</div><div>You can use the included business portfolio ID and WABA ID to verify compliance and begin sending messages, or trigger subsequent onboarding actions as needed. This webhook is the preferred webhook to track MM API for WhatsApp onboarding and eligibility status.</div><div id="bkmrk-receive-onboarding-c"><div id="bkmrk-receive-onboarding-c-1"><div>### Receive onboarding completion webhook (Legacy)

</div></div></div><div>Once you have completed onboarding and linked Ad accounts have been set up, an [`account_update`](/documentation/business-messaging/whatsapp/webhooks/reference/account_update) webhook will be sent for each WABA under your business portfolio to indicate that onboarding has successfully completed. This webhook contains the ID of the read-only Ad account that each WABA is linked to, for use when calling Insights APIs.</div><div>Note: This webhook is considered legacy for MM API for WhatsApp onboarding. Please use the MM API for WhatsApp Terms of Service signed webhook.</div><div>Important: The `ad_account_linked` webhook event will no longer be fired since partners will not receive access to ad accounts.</div></div>

# Setting up conversion measurement | Developer Documentation

<div id="bkmrk-setting-up-conversio">## Setting up conversion measurement

<div><span>Updated: Mar 27, 2026</span></div><div><span></span><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></div><div>Using Marketing Messages API for WhatsApp, you can integrate your marketing messages with events, allowing you to measure the rate and cost at which a Marketing message sent via Marketing Messages API for WhatsApp leads to a downfunnel event like “purchase” on your website or app.</div><div>Conversion measurement is built on the same events that you can send to Meta when using Ads, making it seamless for businesses who are already integrated with Events for Ads purposes (for example, via Pixel or Conversions API for websites, or Meta SDK in their mobile app), to leverage the same reporting automatically with no setup.</div><div>If a business is using both marketing messages on Marketing Messages API for WhatsApp and Ad Campaigns on the same business portfolio, conversion events reported will be automatically attributed to the last Meta touch (either Marketing Messages API for WhatsApp click or Ad click) before the event, based on the attribution window settings of each. For example, if a business is running both an Instagram Ad campaign and a Marketing message campaign on MM API for WhatsApp, each with a URL pointing to the same website for a sale, a user who purchases after clicking on both the Instagram Ad and the Marketing message will be attributed to either the MM API for WhatsApp click or the Ad click, based on the attribution window settings of each. This helps businesses better understand the holistic picture of their Ad and Marketing message campaigns in driving outcomes.</div><div id="bkmrk-understanding-linked"><div id="bkmrk-understanding-linked-1"><div>### Understanding linked Ad entities

</div></div></div><div>When a business registers for Marketing Messages API for WhatsApp, read-only Ad accounts are created under their business portfolio, which are synced to each WhatsApp Business Account under the same portfolio. Note that marketing messages are separate and distinct from Ads - the use of “Ads” terminology below represents the use of Ads entities as technical constructs only.</div><div>No action is needed on the part of the business or partner - these linked read-only Ad accounts are kept in sync with any changes made to Marketing templates, so that any new or updated marketing templates are reflected by their linked ad entity.</div><div>Linking Marketing templates to Ad accounts provides several benefits:</div><div>**Common UI and API for marketing teams:** Businesses can view their Marketing Messages API for WhatsApp marketing campaigns and campaign metrics as “Campaigns” in Ads Manager’s “Marketing Messages” tab, and via API using the Marketing API “[Insights API](https://developers.facebook.com/docs/marketing-api/insights)”. Using these interfaces helps a business’ marketing teams view their Ads and Marketing message campaigns using common interfaces and terminology, instead of viewing Ad campaigns in one place and marketing campaigns sent via WhatsApp in another.</div>
<span>**New metrics:** The Ads Manager UI and Insights API report new Conversion metrics (for example, Web, App) that Cloud API and the Business Management API do not support. When Marketing template messages sent via MM API for WhatsApp lead to Conversion events (for example, add to cart, purchase) that a business reports from their website or app, these conversion events are attributed to the Marketing message and are shown in metrics, leading to a better understanding of Marketing message ROI. Reporting events is done via integration with Pixel or Conversions API for Web and App Events and the Meta SDK.</span><div id="bkmrk-template-to-ad-sync-"><div id="bkmrk-template-to-ad-sync--1"><div>### Template-to-Ad-sync guidelines

</div></div></div>
<span>Marketing templates map to Ads only once during initial onboarding to Marketing Messages API for WhatsApp.</span><span>Syncs must be completed for templates to display correct app conversion metrics.</span><span>Ads syncing can take up to 10 minutes.</span><span>Avoid sending messages with new templates before syncing completes to prevent errors or loss of optimization and tracking.</span><span>Existing templates prior to initial onboarding will not have conversion metrics enabled.</span><span>To reactivate unused templates for over 7 days: Send one message using the template and wait 10 minutes for Ad sync to re-activate.</span><div>![Diagram showing template-to-Ad sync flow](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-iegcz8j5.png)</div><div id="bkmrk-understanding-automa"><div id="bkmrk-understanding-automa-1"><div>### Understanding automatic objective setting

</div></div></div><div>In order to measure Conversion events, Marketing Messages API for WhatsApp automatically syncs Marketing templates to corresponding Ads entities (Campaigns, Message sets, and Ads) with configurations that allow for Conversion reporting of an assumed objective.</div><div>This linking process happens automatically, to reduce the integration complexity of Marketing Messages API for WhatsApp for businesses. For those familiar with Meta’s Ads ecosystem, note that these Campaign and Ad Set parameters will not change how messages are delivered via Marketing Messages API for WhatsApp - they are only set so that reported events can be correctly attributed.</div><div>The following table shows how Marketing templates are mapped to Ads entities.</div><div><table><thead><tr><th></th><th><span>Campaign parameters </span></th><th><span>Message Set parameters </span></th></tr></thead><tbody><tr><td><div><div>Marketing templates with no CTA URL button</div></div></td><td><div><div>Objective:OUTCOME_SALES</div></div></td><td><div><div>OptimizationGoal: Impression</div></div></td></tr><tr><td><div><div>Marketing templates with a CTA URL button that points to a website or app without event reporting enabled.</div></div></td><td><div><div>Objective:LINK_CLICKS</div></div></td><td><div><div>OptimizationGoal: LinkClicks</div></div></td></tr><tr><td><div><div>Marketing templates with a CTA URL button that points to a website or app with event reporting enabled.</div></div></td><td><div><div>Objective:LINK_CLICKS</div></div></td><td><div><div>OptimizationGoal: OffsiteConversion</div></div></td></tr></tbody></table>

</div>
<span>Event reporting is detected by whether the URL points to a website or app which the same business portfolio has enabled for event reporting via Pixel, Conversions API, or Meta SDK.</span><div>While most changes to Templates will be automatically synced with Ads (for example, text content), Campaign and Message set parameters are synced only once when a business first onboards to Marketing Messages API for WhatsApp or creates a new Template, in order to maintain a consistent campaign and message set structure when reporting on clicks and conversions from messages sent using that Template. This means that if you wish to add, edit, or remove a URL from a CTA button on a Template, you must create a new Template in order to correctly capture click and conversion metrics for the updated URL.</div><div id="bkmrk-url-requirements-for"><div id="bkmrk-url-requirements-for-1"><div>### URL requirements for conversion measurement

</div></div></div><div>Meta appends a click ID to the URLs you send in CTA buttons on marketing template messages. The purpose of the click ID is to attribute events you report via Meta Pixel, Conversions API (web or app events), or the Meta SDK.</div><div>The click ID is Meta-generated and is commonly attached as the `fbclid` query parameter.</div><div>Example URL with `fbclid` query parameter:</div><div>```
https://www.jaspersmarket.com/?fbclid=IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk

```

</div><div id="bkmrk-url-compatibility-%28s"><div id="bkmrk-url-compatibility-%28s-1"><div>#### URL compatibility (short links, redirects, and URL rewriting)

</div></div></div><div>Some short-link and redirect services can interfere with conversion measurement if they strip, overwrite, or fail to forward query parameters that Meta appends. If you use a short-link provider or URL rewriting service, ensure it preserves all query parameters end-to-end.</div><div>**Example where fbclid is dropped:**</div>
<span>You configure your CTA destination as: `https://www.jaspersmarket.com/checkout?campaign=whatsapp_template`</span><span>Your link partner rewrites it to a short link that redirects to your site: `https://www.example.com/jaspersmarket`</span><span>Before sending, Meta appends a click ID to the short link: `https://www.example.com/jaspersmarket?fbclid=xyz789`</span><span>When the user clicks, the short-link service redirects to your site but drops the query string, sending the user to: `https://www.jaspersmarket.com/checkout?campaign=whatsapp_template` (missing `fbclid=xyz789`)</span><div>The click ID is not preserved through the redirect, which can reduce Meta’s ability to attribute conversions to the originating click.</div><div id="bkmrk-url-parameter-orderi"><div id="bkmrk-url-parameter-orderi-1"><div>#### URL parameter ordering issues

</div></div></div><div>Appending additional query parameters after the `fbclid` parameter can cause redirection issues on some platforms. If your system adds custom parameters to a URL, ensure that the `fbclid` parameter is not disrupted or truncated by subsequent parameters. Test the full URL (with all parameters) to confirm that the destination resolves correctly and that `fbclid` is accessible to your site or app.</div><div id="bkmrk-recommendations"><div id="bkmrk-recommendations-1"><div>#### Recommendations

</div></div></div><div>If you use short links or redirects:</div>
<span>Test that the final URL retains all query parameters (including `fbclid`).</span><span>Validate conversion reporting in Ads Manager and Insights API before sending production workloads.</span><span>Avoid appending parameters after `fbclid` in ways that could disrupt the URL structure.</span><div>If you experience issues, work with your partner to ensure query parameters are preserved, or reach out to Meta with details.</div><div id="bkmrk-android-deep-links-f"><div id="bkmrk-android-deep-links-f-1"><div>### Android deep links for conversion measurement

</div></div></div><div>Android routes deep links using intent filters declared by apps. A deep link URL has three parts:</div>
<span>Scheme (for example, `https`, `myapp`) — helps determine which app can open the link</span><span>Path (for example, `/product/123`) — the route inside the app</span><span>Query parameters (for example, `?fbclid=...`) — includes attribution data like `fbclid`, `campaignId`, `al_applink_data`, and others</span><div>When a user taps a deep link, Android:</div>
<span>Finds apps with intent filters that match the URL (scheme/host/path).</span><span>Creates an implicit Intent.</span><span>Delivers it to the target Activity (often via `onCreate()` and/or `onNewIntent()`), where the app must read the full URL (including query parameters).</span><div>Android passes the URL, but your app must explicitly capture and persist attribution parameters. If you don’t, they can be effectively “lost” after the first screen.</div><div>Attribution parameters like `fbclid` can be stripped, cached incorrectly, or not passed through as expected due to one or more of:</div>
<span>Android intent resolution behavior (multiple handlers, re-launch behavior, or activity launch modes)</span><span>How WhatsApp invokes app links (intermediary parsing and handoff to Android)</span><span>Receiving app implementation gaps, for example: </span>
<span>Only reading the URL in `onCreate()` but not `onNewIntent()`</span><span>Not persisting the parameters for later use (install/deferred deep linking/session attribution)</span><span>Redirecting internally and dropping query params when rebuilding a new URI</span><div id="bkmrk-implementation-check"><div id="bkmrk-implementation-check-1"><div>#### Implementation checklist

</div></div></div><div>To ensure the click ID works correctly, the receiving Android app should:</div>
<span>Read the full URI from the incoming Intent </span>
<span>Handle both cold start (`onCreate()`) and warm start/re-use (`onNewIntent()`)</span><span>Extract attribution params (at minimum `fbclid`, and any others you rely on)</span><span>Persist them for later conversion reporting/session attribution </span>
<span>Store in a durable place (for example, `SharedPreferences` or a database) with a timestamp</span><span>Refresh if a newer value arrives (these identifiers can change over sessions)</span><span>Do not drop query parameters when redirecting internally </span>
<span>If your app converts a URI to an internal route, ensure you carry attribution params forward or persist them before routing</span><div id="bkmrk-test-deep-link-param"><div id="bkmrk-test-deep-link-param-1"><div>#### Test deep link parameter preservation on Android

</div></div></div><div>When you open a deep link that includes `fbclid`, your app should be able to log (or otherwise confirm) that it received the URI including `fbclid`, and that it persisted it for subsequent events.</div><div>Use a test link like:</div><div>```
myapp://some/path?fbclid=TEST123&campaignId=TESTCAMPAIGN

```

</div><div>Or an `https://` app link equivalent if you support it.</div><div id="bkmrk-test-using-adb"><div id="bkmrk-test-using-adb-1"><div>##### Test using adb

</div></div></div><div>You can simulate what Android does by sending an Intent yourself:</div><div>```
adb shell am start -W -a android.intent.action.VIEW \
  -d "myapp://some/path?fbclid=TEST123&campaignId=TESTCAMPAIGN"

```

</div><div>Then confirm your app receives `fbclid` and persists it.</div><div id="bkmrk-measure-website-conv"><div id="bkmrk-measure-website-conv-1"><div>### Measure website conversions with Meta Pixel or Conversions API

</div></div></div><div>Businesses who are reporting events from their website using Meta Pixel or Conversions API for web, can measure when clicking on a URL in a marketing message sent via Marketing Messages API for WhatsApp leads to one of 3 conversion events.</div><div>If a business is not yet reporting Offsite Conversion events from their website, see the following documentation to set up event reporting:</div><div>**Tutorial**: [Get started with the Meta Pixel and Conversions API<span>⁠</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.facebookblueprint.com%2Fstudent%2Factivity%2F212737&h=AT7n_g2s-Zsk7wFZdkBb9xkHKoX1G9hD7oYeT2bSBjPn99KDB7-9Kr6QK0FCKtBnBJqtHVtUGggfSE1rzVDEI0HFWjjYYojoZUJKTN2RA_YR2YqNrNlvr1-SQylPxmnCD4qRzqlOUqWePQb9_Jz6mQ)</div><div>Once a business is reporting events via Pixel or Conversions API, the following 3 standard events are automatically associated with website visitors who arrived at the site via a CTA URL from a marketing message sent via MM API for WhatsApp:</div>
<span>Add to cart</span><span>Initiate checkout</span><span>Purchase</span><span>Purchase value</span><div>When a user clicks a CTA URL in a Marketing Messages API for WhatsApp message and performs any of the above 3 events, Meta will automatically attribute the conversion event to the MM API for WhatsApp Campaign, and make those analytics available to you or your Partner via the Insights API, which your Partner may surface on their own reporting surfaces that you are accustomed to using.</div><div>Note that if this conversion event is also being used to measure the efficacy of Ads on Facebook or Instagram, Meta will attribute the conversion to the ‘last touch’ interaction of the user. For example, if a user arrives at your website via an ad on Facebook, and then closes their browser window and later that day returns to your website via clicking a link from a MM API for WhatsApp message and purchases an item, that purchase conversion event will be attributed to the MM API for WhatsApp campaign (and not the ad on Facebook) as the most recent interaction.</div></div>

# Tracking click events | Developer Documentation

<div id="bkmrk-tracking-click-event">## Tracking click events

<div><span>Updated: Feb 10, 2026</span></div><div><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></div><div>*Available using Marketing Messages API for WhatsApp (MM API for WhatsApp) and Ads Manager only*</div><div id="bkmrk-limitations"><div id="bkmrk-limitations-1"><div>### Limitations

</div></div></div><span>At the moment, this feature is not available for all users</span><span>Click events are only available for messages sent in the last 7 days</span></div>

# Viewing metrics | Developer Documentation

<div id="bkmrk-viewing-metricsupdat">## Viewing metrics

<div><span>Updated: Feb 10, 2026</span></div><div><span></span><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></div><div><span></span><div>Conversion metrics will be solely available in the WhatsApp Manager UI and WhatsApp Business Management API that businesses use with Cloud API in October 2025.</div><div>As a result, the following conversion metrics will be depreciated:</div>
<span>Viewing conversion metrics via Ads Manager UI (**September 8th, 2025**).</span><span>Viewing conversion metrics via Ads Insights API (**Q1 2026**).</span></div><div>Businesses that use Marketing Messages API for WhatsApp can view metrics from 4 surfaces:</div>
<span>Via WhatsApp Business Platform surfaces </span>
<span>WhatsApp Manager UI</span><span>[WhatsApp Business Management API](/books/meta-whatsapp/page/about-the-whatsapp-business-platform-developer-documentation)</span><span>Via Ads surfaces (optional) </span>
<span>Ads Manager UI “Marketing Messages” tab</span><span>Marketing API “[Insights API](https://developers.facebook.com/docs/marketing-api/insights)”</span><div><table><thead><tr><th><span>ROI Reporting </span></th><th><span>WhatsApp Business Management surfaces </span></th><th><span>Ads surfaces </span></th></tr></thead><tbody><tr><td><div><div>Messages sent, delivered, read</div></div></td><td><div><div>Y</div></div></td><td><div><div>Y</div></div></td></tr><tr><td><div><div>Total amount spent</div></div></td><td><div><div>Y</div></div></td><td><div><div>Y</div></div></td></tr><tr><td><div><div>Cost per delivery</div></div></td><td><div><div>Y</div></div></td><td><div><div>Y</div></div></td></tr><tr><td><div><div>CTA URL link clicks</div></div></td><td><div><div>Y</div></div></td><td><div><div>Y</div></div></td></tr><tr><td><div><div>Cost per click</div></div></td><td><div><div>Y</div></div></td><td><div><div>Y</div></div></td></tr><tr><td><div><div>CTA URL link click rate</div></div></td><td><div><div>N</div></div></td><td><div><div>Y</div></div></td></tr><tr><td><div><div>Add to cart (Web + App)</div></div></td><td><div><div>Y</div></div></td><td><div><div>Y`*`</div></div></td></tr><tr><td><div><div>Checkout initiated (Web + App)</div></div></td><td><div><div>Y</div></div></td><td><div><div>Y`*`</div></div></td></tr><tr><td><div><div>Purchase, purchase value (Web + App)</div></div></td><td><div><div>Y</div></div></td><td><div><div>Y`*`</div></div></td></tr><tr><td><div><div>App Activations</div></div></td><td><div><div>Y</div></div></td><td><div><div>Y`*`</div></div></td></tr><tr><td><div><div>Quick Replies</div></div></td><td><div><div>Y</div></div></td><td><div><div>Y</div></div></td></tr></tbody></table>

</div><div>`*` Requires a business to report this conversion event via Meta Pixel or Conversions API for App Events [see Get started with the Meta Pixel and Conversions API<span>⁠</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.facebookblueprint.com%2Fstudent%2Factivity%2F212737&h=AT4ezKSnMUTXnZNrECFGxgDwTzO_Ioxp8YVcCI1JI5kh2aRptBOJJIM-YtlALemkt3-tcDvhyyXskwLTuFidU7d0oDOSZovrq9ngTVYkhhtO5aWVv3jqKuupW26LTw6Bze0dM54qm59eMiLmeFF7Ow).</div><div id="bkmrk-view-metrics-via-uis"><div id="bkmrk-view-metrics-via-uis-1"><div>### View metrics via UIs

</div></div></div><div>After sending Marketing Messages via Marketing Messages API for WhatsApp, view read-only metrics on sends, clicks, and conversions from two UIs:</div>
<span>WhatsApp Manager</span><span>Ads Manager “Marketing Messages” tab</span><div>Marketing Messages API for WhatsApp metrics, can be viewed in WhatsApp Manager on both Phone Number and Template screens:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-gzy1pgbe.png)</div><div id="bkmrk-benchmarks-and-recom"><div id="bkmrk-benchmarks-and-recom-1"><div>#### Benchmarks and recommendations metrics

</div></div></div><div>Benchmark metrics provide insights into how your business is performing compared to similar businesses in your industry. These metrics are based on data from the past 30 days and take into account various factors that define similar businesses. Based on the benchmark metrics, we provide personalized recommendations to help you improve your template’s performance. If your template’s read rate or click rate falls below the benchmark, we provide suggestions to boost engagement.</div><div id="bkmrk-calculating-benchmar"><div id="bkmrk-calculating-benchmar-1"><div>#### Calculating benchmarks

</div></div></div><div>To calculate benchmark metrics, we consider the following characteristics:</div>
<span>**Business Country or Region**: We use the business country as the default cohort, but if the cohort size is too small, we switch to the business region.</span><span>**Business Industry**: We compare your business with others in the same industry or vertical to provide relevant benchmarks.</span><span>**Template Categories**: We only compare templates within the same category (e.g., marketing templates with other marketing templates) to ensure accurate and relevant benchmarks.</span><div>We then calculate two key benchmark metrics:</div>
<span>**Read Rate Benchmark**: We calculate this metric as the 75th percentile of read rates across similar businesses, representing the percentage of messages read out of total messages delivered.</span><span>**Click Rate Benchmark**: We calculate this metric as the 75th percentile of click rates across similar businesses, representing the percentage of link clicks out of total messages delivered.</span><div id="bkmrk-understanding-your-r"><div id="bkmrk-understanding-your-r-1"><div>#### Understanding your ranking and how to use benchmark metrics

</div></div></div><div>When you view your benchmark metrics, you will see a ranking that indicates how your template performs compared to templates in the same category. This ranking is calculated by comparing your template’s performance with the read rate or click rate performance of peer templates with high engagement over the past 30 days.</div><div>Use the benchmark metrics to compare your template’s performance to templates from similar businesses over the past 30 days. Benchmarks are calculated daily, with a delay of up to 2 days. This ensures that you have access to updated and relevant data to inform your business decisions.</div><div>To access the benchmark and recommendations metrics:</div>
<span>Go to the WhatsApp Manager and select “Manage templates”.</span><span>Choose the template you want to view.</span><span>Select the “Marketing Messages API for WhatsApp” option from the dropdown menu highlighted in red.</span><span>The benchmark metrics and recommendation cards will be displayed below the preview card in the left panel.</span><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-smsaziya.png)</div><div id="bkmrk-error-metrics"><div id="bkmrk-error-metrics-1"><div>#### Error metrics

</div></div></div><div>You can see a summary of error messages your template encountered within a given period of time by navigating to the [**WhatsApp Manager**<span>⁠</span>](https://business.facebook.com/latest/whatsapp_manager/) &gt; **Message templates** &gt; **Manage templates** panel and clicking on the template. Errors are displayed in the **Error messages** section.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-25rytgdf.png)</div><div>The period of time can be defined using the date selector dropdown at the top of the page. See [Cloud API error codes](/documentation/business-messaging/whatsapp/support/error-codes) for a list of error codes and their descriptions.</div><div>The most frequently encountered message delivery errors are displayed in the **Summary** tab:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-tncpiutz.png)</div><div>This information is also displayed as trend lines in the **Trend** tab:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-gngkls67.png)</div></div>

# Deep links | Developer Documentation

<div id="bkmrk-deep-linksupdated%3A-f">## Deep links

<div><span>Updated: Feb 10, 2026</span></div><div><span></span><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></div><div>You can map an [Android deep link<span>?</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Fdeveloper.android.com%2Ftraining%2Fapp-links%2Fdeep-linking&h=AT5ztASnqn8MtmdCz4OqQ1_YbODtOwkw3MgzqS0ctYDkm0V_-i7Ix2zbrfkjsZ-pFSxHxJhP9ioBcpWrWb5HQIgr5sbBKLTKIIKilr2G-wfQ4QKHky0l3AZqICPBies8dH6zhRAyL8Mqcq2OIy5dQg) to a marketing template URL button that, when tapped, loads a particular location or content within your app.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-h1jggr2m.png)</div><div>If you have not onboarded to the Marketing Messages API for WhatsApp (MM API for WhatsApp), your marketing templates will not display any conversion metrics. Learn more about how to [measure conversion](/books/meta-whatsapp/page/setting-up-conversion-measurement-developer-documentation).</div><div id="bkmrk-template-creation-vi"><div id="bkmrk-template-creation-vi-1"><div>### Template creation via WhatsApp Manager

</div></div></div><div>To create a template with a button mapped to an Android deep link:</div>
<span>Access [WhatsApp Manager<span>?</span>](https://business.facebook.com/latest/whatsapp_manager/).</span><span>Navigate to the **Message templates** &gt; **Manage templates** panel and click the **Create template** button.</span><span>Select **Marketing** (tab) &gt; **Custom** (radio button) and click the **Next** button.</span><span>In the **Buttons** section, click the **+ Add buttons** dropdown menu and select **Visit website**.</span><span>Check the **Track app conversions** checkbox to reveal the deep link fields (pictured below).</span><span>Complete each field using their tooltips or [form field](#bkmrk-form-fields-1) descriptions below as guidance.</span><span>Add any additional components you'd like your template to use, name your template, and submit it for approval.</span><div>Note that you can also use the **Manage templates** panel to edit an existing template and add a deep link-mapped button, but the template will have to undergo template review again.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-vijkfmys.png)</div><div id="bkmrk-form-fields"><div id="bkmrk-form-fields-1"><div>#### Form fields

</div></div></div><div><table><thead><tr><th><span>Field label </span></th><th><span>Description </span></th><th><span>Example value </span></th></tr></thead><tbody><tr><td><div><div>Android deep link</div></div></td><td><div><div>**Required.** Android deep link URI.</div></div></td><td><div><div>luckyshrub://deals/summer_solstice</div></div></td></tr><tr><td><div><div>Android fallback URL</div></div></td><td><div><div>**Optional.** Fallback URL. If the WhatsApp client cannot load the deep link URI, the client will load this URL in the device's default web browser.</div><div>If omitted, the client will attempt to load the URL specified in the Website URL field instead.</div></div></td><td><div><div>https://www.luckyshrub.com/deals/summer_solstice</div></div></td></tr><tr><td><div><div>Button Text</div></div></td><td><div><div>**Required.** Button label text. Maximum 25 characters.</div></div></td><td><div><div>View deal</div></div></td></tr><tr><td><div><div>Meta app ID</div></div></td><td><div><div>**Required.** This is a list of the Meta app(s) associated with your business portfolio. Select the app whose access token you will use to send the template.</div></div></td><td><div><div>Lucky Shrub (634974688087057)</div></div></td></tr><tr><td><div><div>Type of Action</div></div></td><td><div><div>Required.</div><div>Must be set to **Visit website**.</div></div></td><td><div><div>Visit website</div></div></td></tr><tr><td><div><div>URL Type</div></div></td><td><div><div>**Required.** Set to **Static** if your Android deep link or Android fallback URL has no dynamic values, otherwise set to **Dynamic**.</div></div></td><td><div><div>Static</div></div></td></tr><tr><td><div><div>Website URL</div></div></td><td><div><div>**Required.**</div><div>URL of a website to load if the WhatsApp user views the message on a non-Android device, or if the WhatsApp client cannot load your Android deep link URI and no Android fallback URL is specified.</div></div></td><td><div><div>https://www.luckyshrub.com/</div></div></td></tr></tbody></table>

</div><div id="bkmrk-viewing-metrics"><div id="bkmrk-viewing-metrics-1"><div>### Viewing metrics

</div></div></div><div>See our [Viewing metrics](/books/meta-whatsapp/page/viewing-metrics-developer-documentation) document.</div></div>

# Send Marketing Messages | Developer Documentation

<div id="bkmrk-send-marketing-messa">## Send Marketing Messages

<div><span>Updated: Mar 20, 2026</span></div><div><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></div><div>Marketing Messages API for WhatsApp allows you to send marketing template messages only. To send other message types or receive messages, use Cloud API in parallel with Marketing Messages API for WhatsApp on the same business phone number.</div><div>If you use a partner’s UI portals or APIs to configure and send marketing messages, you can continue to do so, and do not need to use any of the capabilities described in this document - your partner will take care of integrating with MM API for WhatsApp’s message sending functions on your behalf.</div><div id="bkmrk-create-marketing-tem"><div id="bkmrk-create-marketing-tem-1"><div>### Create marketing templates

</div></div></div><div>Marketing templates can be created in several ways:</div><span>Via WhatsApp Business Manager UI</span><span>Via the Business Management API “Message Templates” endpoint</span><span>If you work with a partner, your partner may offer their own API or user interfaces for template creation, which leverage the “Message Templates” endpoint</span><div>See documentation on how to [Create and manage templates](/books/meta-whatsapp/page/templates-developer-documentation).</div><div>When you create a new marketing template, it takes up to 10 minutes to sync with the corresponding Ad account. This sync allows messages to be optimized and enables measurement of clicks and downstream conversions. Templates inactive for longer than 7 days also require 10 minutes to sync after first use. Wait 10 minutes after creating new marketing templates before sending marketing traffic. The same applies after sending the first marketing message on a dormant template.</div><div>Marketing Messages API for WhatsApp supports all marketing templates. In addition, Marketing Messages API for WhatsApp provides the following features that are not available to marketing templates on Cloud API:</div><span>**Time-To-Live (TTL) for Marketing template messages:** If Meta is unable to deliver a message to a WhatsApp user, Meta will retry the delivery for a period of time known as a time-to-live, TTL, or the message validity period. TTL is available for Authentication and Utility template messages on Cloud API, but TTL for Marketing template messages is exclusively available on MM API for WhatsApp. See documentation on how to [Create and Manage Templates via API](/books/meta-whatsapp/page/templates-developer-documentation) or [How to set a custom message validity period via UI<span>⁠</span>](https://www.facebook.com/business/help/1305007343713790) for details on how to set TTLs for Marketing template messages.</span><div id="bkmrk-other-optimizations"><div id="bkmrk-other-optimizations-1"><div>### Other optimizations

</div></div></div><div id="bkmrk-text-truncation"><div id="bkmrk-text-truncation-1"><div>#### Text truncation

</div></div></div><div>Meta truncates text to a specific line-count to increase performance. No text content is changed, the original text is still accessible through the “Read more” button. The exact line count truncation rules are as follows:</div><span>**Messages without any CTA, but with a link in the message body** (overrides the below rules): truncated to 5 lines</span><span>**Messages with a media header** ([Image](/books/meta-whatsapp/page/image-messages-developer-documentation), [Video](/books/meta-whatsapp/page/video-messages-developer-documentation), [Document](/books/meta-whatsapp/page/document-messages-developer-documentation), [Location](/books/meta-whatsapp/page/template-messages-developer-documentation), and [GIF](/books/meta-whatsapp/page/template-components-developer-documentation)): truncated to 3 lines</span><span>**Messages without a header** (that is, [Text messages](/books/meta-whatsapp/page/template-messages-developer-documentation)): truncated to 4 lines</span><div id="bkmrk-send-marketing-templ"><div id="bkmrk-send-marketing-templ-1"><div>### Send marketing template messages

</div></div></div><div>Sending messages follows the same API payload syntax as Sending Messages on Cloud API, and requires the same permissions.</div><div>The `/marketing_messages` endpoint supports **only** marketing template messages for MM API for WhatsApp and Cloud API. All other message types (freeform, Authentication, Service, Utility) are not supported, and will produce an error.</div><div>Marketing messages will only be sent via MM API for WhatsApp when the business customer has met all [onboarding requirements](/books/meta-whatsapp/page/onboard-developer-documentation). If onboarding requirements are not met, the marketing messages will still be routed via Cloud API. You may disable the ability to route to Cloud API by setting the optional field `product_policy` to `STRICT`.</div><div>Note: You may still use the `/messages` endpoint to send marketing messages through the Cloud API.</div><div id="bkmrk-request-syntax-12"><div id="bkmrk-request-syntax-13"><div>#### Request syntax

</div></div></div><div>MM API for WhatsApp provides the following additional features that are not available to Marketing template messages on Cloud API:</div><div>**Product fallback policy:** Set `product_policy` to `CLOUD_API_FALLBACK` to have the API send the outgoing message via Cloud API, if [onboarding requirements](/books/meta-whatsapp/page/onboard-developer-documentation) have not been met. Set to `STRICT` if you do not want the API to fallback to sending the message via Cloud API.</div><div>**Message activity sharing:** `message_activity_sharing` is an optional parameter at the message level that enables or disables sharing message activities (for example, message read) for that specific marketing message to Meta to help optimize marketing messages. If this parameter is not provided, the default WABA-level setting will be applied. You can always edit your default setting in Business Settings (see Changelog for a screenshot of this).</div><div>For details on message types, reference the Cloud API [Message Types documentation](/books/meta-whatsapp/page/sending-messages-developer-documentation), as MM API for WhatsApp uses the same message send formatting.</div><div id="bkmrk-receiving-message-st"><div id="bkmrk-receiving-message-st-1"><div>### Receiving message status webhooks

</div></div></div><div>MM API for WhatsApp triggers status [messages](/books/meta-whatsapp/page/status-messages-webhook-reference-developer-documentation) webhooks (sent, delivered, read). In addition, status messages webhooks that describe a message sent via MM API for WhatsApp, and that include pricing information, will have `pricing.category` and `conversation.type` set to `marketing_lite`. If the message is routed via Cloud API, `pricing.category` will be set to `marketing`.</div><div>Maintain logs of each outgoing message ID, and whether that ID was sent via Cloud API or MM API for WhatsApp, in order to use the unique message ID returned in message status webhooks to identify the origin of the sent message.</div><div id="bkmrk-receiving-incoming-m"><div id="bkmrk-receiving-incoming-m-1"><div>### Receiving incoming messages

</div></div></div><div>MM API for WhatsApp is a send-only API. It does not receive incoming messages from consumers. To receive incoming messages on a business phone number, use Cloud API in parallel with MM API for WhatsApp on the same phone number.</div></div>

# Onboard business customers | Developer Documentation

<div id="bkmrk-onboard-business-cus">## Onboard business customers

<div><span>Updated: Feb 10, 2026</span></div><div><span></span><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></div><div>The MM API for WhatsApp onboarding process is designed to be simple for you as a partner to adopt, making it quick and easy for [solution providers](/books/meta-whatsapp/page/solution-providers-developer-documentation) (including Solution Partners, Tech Providers, and Tech Partners) to onboard current customers from Cloud API onto the MM API for WhatsApp. If your business directly integrates with Cloud API without a partner, follow the instructions below to accept the Terms of Service and onboard to the MM API for WhatsApp via WhatsApp Manager.</div><div id="bkmrk-before-you-begin"><div id="bkmrk-before-you-begin-1"><div>### Before you begin

</div></div></div><div>Your app must have advanced access for the following permissions:</div>
<span>**`whatsapp_business_messaging`**: This permission allows the app to call the MM API for WhatsApp to send messages.</span><span>**`whatsapp_business_management`**: This permission enables the app to manage WABAs, Phone Numbers, and Templates via [WhatsApp Business Management API](/books/meta-whatsapp/page/analytics-developer-documentation).</span><span>**`ads_read`** (optional): This permission grants the app access to the [Insights API](https://developers.facebook.com/docs/marketing-api/insights), allowing partners to retrieve metrics on conversions.</span><div>If your app does not already have advanced access for these permissions, request advanced access via [App Review](/books/meta-whatsapp/page/app-review-developer-documentation).</div><div id="bkmrk-solution-partner-int"><div id="bkmrk-solution-partner-int-1"><div>### Solution partner integration overview

</div></div></div><div>To assist your customers in using the MM API for WhatsApp, several steps are required:</div><div><table><thead><tr><th><span>Step </span></th><th><span>Notes </span></th></tr></thead><tbody><tr><td><div><div>1: Onboard yourself</div></div></td><td><div><div>Enroll via [App Dashboard](https://developers.facebook.com/apps) and follow instructions under the [Onboarding yourself](#bkmrk-onboarding-yourself-1).</div></div></td></tr><tr><td><div><div>2: Send messages</div></div></td><td><div><div>Same Template endpoint and message send payload as Cloud API - only the ‘send message’ endpoint changes.</div></div></td></tr><tr><td><div><div>3: View metrics</div></div></td><td><div><div>**New!** Integrate with the Insights API to view the metrics as Cloud API (sent/read/delivered), plus new metrics like Website and App conversions.</div></div></td></tr></tbody></table>

</div><div id="bkmrk-onboarding-yourself"><div id="bkmrk-onboarding-yourself-1"><div>### Onboarding yourself

</div></div></div><div id="bkmrk-register-yourself-fo"><div id="bkmrk-register-yourself-fo-1"><div>#### Register yourself for MM API for WhatsApp

</div></div></div><div>To enroll, a solution provider must:</div>
<span>Navigate to the **[App Dashboard](/apps)** &gt; **WhatsApp** &gt; **Quickstart** panel</span><span>On the **Quickstart** page, locate the “Improve ROI with Marketing Messages API for WhatsApp” card and click the “Get started” button</span><span>Request any missing app review permissions by clicking the “Request permission” button. See “[Submit for app review](/books/meta-whatsapp/page/app-review-developer-documentation)” for more information</span><span>Click on “Continue to integration guide” to accept the Terms of Service</span><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-qgaeeueg.png)</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-dt3adbup.png)</div><div id="bkmrk-submit-for-app-revie"><div id="bkmrk-submit-for-app-revie-1"><div>#### Submit for app review for Advanced App permissions

</div></div></div><div>Solution Providers must use an App with the following Advanced App permissions, when using the MM API for WhatsApp.</div><div>If you do not already have an App with the following Advanced App Permissions, it is necessary for your App to go through [App review](/books/meta-whatsapp/page/app-review-developer-documentation):</div><div><table><thead><tr><th><span>Advanced App Permission </span></th><th><span>Required in order to do the following on behalf of your customer </span></th></tr></thead><tbody><tr><td><div><div>`whatsapp_business_messaging`</div></div></td><td><div><div>Call the MM API for WhatsApp ‘send messages’ endpoint, to send messages via Marketing Messages API for WhatsApp</div></div></td></tr><tr><td><div><div>`whatsapp_business_management`</div></div></td><td><div><div>Call WABA, Phone Number, and Template endpoints, for managing WABAs, Phone Numbers, and Templates; and retrieve basic metrics via [WhatsApp Business Management API](/books/meta-whatsapp/page/analytics-developer-documentation)</div></div></td></tr><tr><td><div><div>`ads_read` (optional)</div></div></td><td><div><div>This permission is optional, and is only required to call the [Insights API](https://developers.facebook.com/docs/marketing-api/insights), allowing a partner to fetch advanced metrics on conversions (e.g. Web conversions, App conversions)</div></div></td></tr></tbody></table>

</div><div>For the app review submission, prepare a screen recording of how each permission is used. It is recommended to show a sample of each action in the “Required in order to do …” column above, to demonstrate each permission in use.</div><div id="bkmrk-help-the-business-se"><div id="bkmrk-help-the-business-se-1"><div>### Help the business set up Conversion measurement

</div></div></div><div>See [Setting up conversion measurement](/books/meta-whatsapp/page/setting-up-conversion-measurement-developer-documentation) for details on how businesses can measure when a marketing message from MM API for WhatsApp leads to a conversion (e.g. add to cart, purchase).</div><div>Partners are **strongly recommended** to work with their clients to set up Conversion reporting, so that they can take advantage of measuring the improved metrics and optimizations MM API for WhatsApp provides.</div><div id="bkmrk-sending-messages"><div id="bkmrk-sending-messages-1"><div>### Sending messages

</div></div></div><div>See [Sending messages](/books/meta-whatsapp/page/send-marketing-messages-developer-documentation) for documentation on how to send messages and receive webhooks on behalf of your customers via MM API for WhatsApp.</div><div id="bkmrk-viewing-metrics"><div id="bkmrk-viewing-metrics-1"><div>### Viewing metrics

</div></div></div><div>See the Guide to [Viewing metrics](/books/meta-whatsapp/page/viewing-metrics-developer-documentation) for documentation on how to:</div>
<span>Fetch the IDs of the Ad entities mapped to a business’ WABAs and Templates, in order to call Insights APIs.</span><span>Fetch metrics for messages sent via MM API for WhatsApp.</span><div>Partners are **strongly recommended** to fetch metrics using the Ads Insights APIs (not Business Management APIs), as these APIs provide richer metrics reporting, including conversion reporting from sources such as Web and App conversion events.</div><div>After integrating with reporting APIs (Insights API recommended), surface these metrics in your dashboards and APIs for your customers to use.</div><div>Reach out to your Partner Manager for suggestions on metrics best practices, including a copy of Meta’s “**Business Messaging Reporting Dashboards Playbook**” for partners.</div></div>

# Set a max-price for marketing messages (BETA) | Developer Documentation

<div id="bkmrk-set-a-max-price-for-">## Set a max-price for marketing messages (BETA)

<div><span>Updated: Mar 17, 2026</span></div><div><div>Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available.</div></div><div><div>Amidst our introduction of the max-price feature on the Marketing Messages API for WhatsApp, there is no change to how we charge on the WhatsApp Business Platform. We continue to charge on a per-message basis, as outlined [here](/books/meta-whatsapp/page/pricing-on-the-whatsapp-business-platform-developer-documentation).</div><div>The max-price feature will become available via Limited Beta as of mid-May and be **optional** throughout 2026.</div></div><div id="bkmrk-what-is-a-max-price%3F"><div id="bkmrk-what-is-a-max-price%3F-1"><div>### What is a max-price?

</div></div></div><div>As announced in March 2026 -- in 2026, we're introducing new pricing features on the Marketing Messages API for WhatsApp to enable businesses to *drive higher ROI* and *have more control* to optimize spend for their marketing messaging campaigns.</div><div>Our first pricing feature allows businesses to **set a maximum price (max-price) per marketing message delivery; when a max-price is set, Meta will charge that max-price or lower for delivery**. Businesses can choose to set a max-price the same as, lower than, or higher than the published rate to achieve their objectives per campaign.</div><span>*Lower costs while maintaining delivery rates similar to current WhatsApp campaigns*, by setting max-prices the same as published rates.</span><span>*Target a broader range of customer cohorts on WhatsApp at lower cost*, by setting max-prices lower than published rates.</span><span>*Increase delivery rates when customer engagement matters most*, like during holidays and peak sales periods, by setting max-prices higher than published rates.</span><div>The second pricing feature is the **reach estimation tool**, which helps businesses set the right max-price by helping them understand estimated delivery rates and costs at different max-prices.</div><div id="bkmrk-max-price-explainer"><div id="bkmrk-max-price-explainer-1"><div>#### Max-price explainer

</div></div></div><div>The max-price feature allows you to set the maximum price you are willing to pay per message delivery. You are charged your max-price or lower. In the API, you express this as a `bid_amount` value per 1,000 deliveries within the `bid_spec` object.</div><span>[Max-price explainer PDF](https://l.facebook.com/l.php?u=https%3A%2F%2Fscontent-ams2-1.xx.fbcdn.net%2Fv%2Ft39.8562-6%2F652260051_2871429753198389_1292317443132886324_n.pdf%3F_nc_cat%3D107%26ccb%3D1-7%26_nc_sid%3Db8d81d%26_nc_ohc%3DR6IMKT9-QbUQ7kNvwHjw-7R%26_nc_oc%3DAdqbSrK358oRJw-PoC_zAuZTJyCer5yWR5--ujHnbN32-ShuqTNKhzSg-kI5nHf1DrY%26_nc_zt%3D14%26_nc_ht%3Dscontent-ams2-1.xx%26_nc_gid%3DG3aCMxUEd71RXXgD-zWp7A%26_nc_ss%3D7a389%26oh%3D00_Af2SIuA8sYJ1__1IsCmPyeiqoqLnMBYindACx8faFemOfg%26oe%3D69D2BE07&h=AT6NcVZ1hYYwjZeFVS2UBzDwiLgHPEtHRqVr9M9YL6gQxyWuqVcSwXsqepxwE5g5kUOm73CmgWOvdEOLoDyeVRK6g4wAB4OsKQmiIfPQGqZmg74zyCs399JaiOa2tiR6G-H1L_r0IQrNZo1j6rx09g)</span><div id="bkmrk-phased-roll-out-of-t"><div id="bkmrk-phased-roll-out-of-t-1"><div>### Phased roll-out of the max-price feature

</div></div></div><div>We plan to roll out our max-price feature in 3 phases:</div><span>Limited Beta starting **mid-May 2026** -- Any partner and any directly-integrated business can integrate and use the max-price feature and reach estimation tool. Each partner can enable these features for a limited number of clients.</span><span>Open Beta starting **October 2026** -- Any partner can enable these features for all their clients.</span><span>General Availability (GA) as of **Q2 2027** -- The max-price feature will become required in eligible geographies and fixed, published rates for marketing messages will only apply on the Cloud API.</span><div id="bkmrk-before-you-begin"><div id="bkmrk-before-you-begin-1"><div>### Before you begin

</div></div></div><div>To use the max-price feature, you must:</div><span>Have an active WhatsApp Business Account that has been [onboarded](/books/meta-whatsapp/page/onboard-developer-documentation) to the Marketing Messages API for WhatsApp.</span><span>Be in a [country eligible for MM API for WhatsApp](/books/meta-whatsapp/page/get-started-developer-documentation).</span><div id="bkmrk-recommendations"><div id="bkmrk-recommendations-1"><div>### Recommendations

</div></div></div><div>Set your max-price at the template level. The `bid_amount` in `bid_spec` is what Meta's delivery system optimizes against. Setting the right max-price when you create the template gives the system the best signal for delivery optimization.</div><div>The `per_message_bid_multiplier` scales the template's `bid_amount` up or down for individual messages, but the delivery system generally gives better performance optimizing based on the original template-level `bid_amount` on large amount.</div><div>For example, if you set a template's `bid_amount` to 50,000 and then apply a multiplier of 2.0 on every message, delivery performance might differ from setting the template's `bid_amount` to 100,000 directly -- even though the effective max-price is the same. Hence we recommend setting up the bid at template level and update the template's `bid_spec` if needed rather than changing the message level multiplier as a workaround.</div><div>Ramp up traffic gradually. When sending messages with a new max-price template for the first time, increase volume slowly before sending at scale. This aligns with [Template pacing](/books/meta-whatsapp/page/template-pacing-developer-documentation) best practices and helps the delivery system optimize effectively.</div><div id="bkmrk-create-templates-wit"><div id="bkmrk-create-templates-wit-1"><div>### Create templates with max-price

</div></div></div><div id="bkmrk-request-syntax"><div id="bkmrk-request-syntax-1"><div>#### Request syntax

</div></div></div><div>If `bid_spec` is not included, the template uses standard rate card pricing.</div><div id="bkmrk-request-parameters"><div id="bkmrk-request-parameters-1"><div>#### Request parameters

</div></div></div><div><table><tbody><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example Value </span></th></tr><tr><td><div><div>`<ACCESS_TOKEN>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>[System token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation) or [business token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation).</div></div></td><td><div><div>```
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
```

</div></div></td></tr><tr><td><div><div>`<API_VERSION>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Graph API version.</div></div></td><td><div><div>v25.0</div></div></td></tr><tr><td><div><div>`<WABA_ID>`*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp Business Account ID.</div></div></td><td><div><div>`102290129340398`</div></div></td></tr><tr><td><div><div>`<BID_AMOUNT>`</div><div>*int*</div></div></td><td><div><div>**Required.**</div><div>Maximum price per 1,000 message deliveries, expressed in your WABA currency's smallest unit (cents for USD, paise for INR, peso for MXN). See [supported currencies](/books/meta-whatsapp/page/pricing-on-the-whatsapp-business-platform-developer-documentation) for a list of currencies.</div></div></td><td><div><div>`87000`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-calculating-max-pric"><div id="bkmrk-calculating-max-pric-1"><div>#### Calculating max-price amounts

</div></div></div><div>The `bid_amount` represents your max-price per 1,000 deliveries in your WABA currency's smallest unit. To convert from your desired per-delivery price:</div><span>Convert your desired per-delivery price to your WABA currency's smallest unit</span><span>Multiply by 1,000 to express the value per 1,000 deliveries</span><div>**Example**: To set a max-price of ?0.87 per delivery:</div><span>Convert to paise: 0.87 Rupees = 87 paise</span><span>Multiply by 1,000: 87 x 1,000 = 87,000</span><div>Set `bid_amount` to `87000`.</div><div>**Example**: To set a max-price of $0.05 USD per delivery:</div><span>Convert to cents: $0.05 = 5 cents</span><span>Multiply by 1,000: 5 x 1,000 = 5,000</span><div>Set `bid_amount` to `5000`.</div><div id="bkmrk-metrics-and-billing"><div id="bkmrk-metrics-and-billing-1"><div>### Metrics and billing

</div></div></div><div>Messages sent with or without the max-price feature use the same **Marketing Lite** product type (SKU) for billing purposes.</div><div>Marketing messages sent with max-price appear in analytics with the following identifiers:</div><span>**Pricing Analytics**[`/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=pricing_analytics`](/books/meta-whatsapp/page/analytics-developer-documentation): `pricing_category` = `MARKETING_LITE`</span><span>**Template Analytics**[`/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=template_analytics`](/books/meta-whatsapp/page/analytics-developer-documentation): `product_type` = `MARKETING_MESSAGES_LITE_API`</span><div>Webhooks use lowercase `marketing_lite` for `pricing.category`, while analytics APIs use uppercase `MARKETING_LITE` for `pricing_category`.</div><div id="bkmrk-pricing-analytics-re"><div id="bkmrk-pricing-analytics-re-1"><div>#### Pricing analytics response example

</div></div></div><div id="bkmrk-template-analytics-r"><div id="bkmrk-template-analytics-r-1"><div>#### Template analytics response example

</div></div></div><div>For more details on metrics, see [Viewing metrics](/books/meta-whatsapp/page/viewing-metrics-developer-documentation).</div><div id="bkmrk-error-codes"><div id="bkmrk-error-codes-1"><div>### Error codes

</div></div></div><div><table><tbody><tr><th><span>Code</span></th><th><span>Message</span></th><th><span>Possible reasons and solutions</span></th></tr><tr><td><div><div>131061</div></div></td><td><div><div>Marketing templates containing bid_spec are not supported by the Cloud API. To use templates with bid_spec, please use the Marketing Messages API for WhatsApp.</div></div></td><td><div><div>You are sending a template with `bid_spec` to the Cloud API `/messages` endpoint. Send to the `/marketing_messages` endpoint instead.</div></div></td></tr><tr><td><div><div>100</div></div></td><td><div><div>You need to sign the testing legal agreement before sending out messages.</div></div></td><td><div><div>You have not signed the testing legal agreement. Please sign the agreement to gain access to this feature.</div></div></td></tr></tbody></table>

</div><div>For a full list of error codes, see [Error codes](/documentation/business-messaging/whatsapp/support/error-codes).</div></div>