Skip to main content

Marketing Messages API for WhatsApp

Last updated: 24 November 2025

The Marketing Messages API for WhatsApp is a new solution for marketing messages designed to improve the quality of service for recipients and achieve better results for businesses through optimizations on Meta's side.

developers.facebook.com

Key Benefits

  • Increase in the number of marketing messages delivered and read.
  • Improved service quality and recipient engagement.
  • Ability to set more dynamic limits on the number of messages, so marketing messages with high engagement levels can reach more recipients.
  • Budget savings by increasing the effectiveness of mailings.
  • Increased stability of marketing campaigns.
  • Fast and stable processing of your messages under high loads.

developers.facebook.com

warning

When using the Marketing Messages API, Meta decides whether to deliver the message to the end recipient.

Connection Requirements

  • The company must comply with applicable legal restrictions, as well as restrictions outlined in WhatsApp Business Messaging Policy.

    business.whatsapp.com

  • WhatsApp Business Account is active and not restricted from messaging due to any violations.

  • The country of the business owner and WhatsApp Business Account is not in sanctioned regions.

info

The Marketing Messages API requirements and policies are regularly updated to comply with various international rules and regulations, refer to the current version on the Facebook website.

developers.facebook.com

Geographic Availability of Features

Some advanced features and reporting capabilities of Marketing Messages API for WhatsApp are available only in particular geographies due to Meta policy or local regulation.

developers.facebook.com

How to Enable Marketing Messages API

  1. Log in to Business Manager and go to the AccountsWhatsApp Accounts section.

    tip

    To quickly go to the WhatsApp Accounts section, use the direct link.

    business.facebook.com

  2. Select the WhatsApp account for which you want to enable Marketing Messages API.

  3. Click WhatsApp Manager and go to the Overview section.

    tip

    To quickly go to the Overview section, use the direct link.

    business.facebook.com

  4. In the Alerts section, click Accept terms to get started.

    info

    If the notification you need isn't in the Overview section, go to Message TemplatesManage Templates and click Accept terms to get started in the notification area.

    To quickly go to the Manage Templates section, use the direct link.

    business.facebook.com

  5. Read the Marketing Messages API terms of servise and click Accept.

info

To use the Marketing Messages API, move the WhatsApp Business Accounts from the On-Behalf-Of category to Shared.

warning

If a client does not accept Meta's updated policy and attempts to send a message via the Marketing Messages API with optimization, WhatsApp will return an error 134102: mrkt-onboarding-or-syncing-incompleted - account did not accept the updated Meta policy or template synchronization error.

How to Disable Marketing Messages API Optimization

  1. Log in to Business Manager.

  2. Go to the WhatsApp Accounts section.

    business.facebook.com

  3. Select the WhatsApp account for which you want to disable optimization.

  4. In the Privacy and data sharing section, turn off the Optimize marketing messages by sharing event activity with Meta setting.

    developers.facebook.com