Marketing Message API for Messenger overview
Updated: May 5, 2026
This page provides an overview of the integration steps for the Marketing Message API for Messenger, which enables businesses to send paid marketing messages to people who have opted in to receive them.
The Marketing Message API for Messenger is available exclusively to tech providers with an existing app that has successfully completed Meta App Review for the following permissions:
- ads_management
- pages_messaging
- paid_marketing_messages or marketing_messages_messenger
Currently, tech providers can only serve businesses located in the following regions:
- Australia
- Brazil
- Chile
- Colombia
- Hong Kong
- India
- Indonesia
- Israel
- Malaysia
- Mexico
- New Zealand
- Peru
- Philippines
- Saudi Arabia
- Singapore
- Taiwan
- Thailand
- United Arab Emirates
- United States
- Vietnam (VN)
In addition, messages can be sent to users/subscribers in all regions except:
- European Union
- Japan
- South Korea
- Australia
- United Kingdom
The Marketing Message API for Messenger is only available for Web applications.
Preparation
Prepare the following items to ensure a smooth integration with the Marketing Message API for Messenger:
- A Meta developer account
- A Facebook Page, Meta business portfolio(optional), and a Meta ad account that is eligible for marketing messages in Ads Manager to use as test accounts. Ensure the ad account has a payment method set up. Follow this guide for setting up payment.
- You must have an established Business type Meta app.
- Your app must be in Live mode for testing the product.
- Your app must have these 3 required features:
- Messenger product configured with the Facebook Page you intend to use.
- Facebook Login for Business
- Marketing API Access Tier
- Your app must have Advanced access for 3 required permissions:
ads_managementpages_messagingpaid_marketing_messagesormarketing_messages_messenger
- A server that can receive Messenger webhook event notifications.
- The app should be owned by a Meta business portfolio that is different from the one associated with your test accounts (Facebook Page, Meta business portfolio, and Meta ad account).
Integration overview
The following steps outline the typical integration flow for supporting businesses in sending paid Marketing Messages:
| Step | Summary |
|---|---|
1: Onboarding | Create a new Facebook Login for Business configuration in the Meta App Dashboard to onboard businesses using your app. This new configuration asks businesses for the required permissions, access tokens, assets, and to sign the Terms of Service. |
Businesses can only send Marketing Messages to people who have opted in to receive them. Get a list of a business’ subscription tokens that represent people who have opted in to receive Marketing Messages from that business. See Get subscription tokens for details. | |
3: Sending messages | You will need to support businesses in composing and sending of Marketing Messages by building a UI in your app.
Once you’re ready to send the Marketing Message campaign, select one of two API options:
|
Integrate with Meta’s insights and campaign management APIs to allow businesses using your app to view metrics for marketing message campaign performance. See Measure campaign performance for details. | |
Growing the subscriber base increases the reach of marketing message campaigns. Multiple options are available, such as turning people who clicked Click-to-Messenger ads into subscribers. See Grow your audience for details. |
Next Steps
Now that you understand the integration steps, you can begin the onboarding process.
See also
- Marketing Message API Reference — full API endpoint documentation
- Marketing Messages FAQ — common questions about marketing messages
- Messenger Platform Policy — messaging policies and compliance requirements