> ## Documentation Index
> Fetch the complete documentation index at: https://whatsapp-docs.kap.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started

# Get started

Updated: Dec 4, 2025

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

Learn how to send a template message with the Marketing Messages API for WhatsApp (MM API for WhatsApp).

## Requirements

You have an active WhatsApp Business Account and are in a [country eligible for MM API for WhatsApp](https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/get-started#geographic-availability-of-features).
You have an approved [marketing template message](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates).
You are subscribed to the [messages](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages) webhook.

## Step 1: Accept Terms of Service

Navigate to the [**App Dashboard**](https://developers.facebook.com/apps) > **WhatsApp** > **Quickstart** panel.
Locate the “ **Improve ROI with marketing messages with optimizations**” module and click the “ **Get started**” button.
Click on “ **Continue to integration guide**” and accept the Terms of Service.

## Step 2: Send a marketing template message

Use the `marketing_messages` endpoint to send a template message to yourself.

```
curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/marketing_messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d
'{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "type": "template",
  "template": {
      "name": "<TEMPLATE_NAME>",
      "language": {
          "code": "<LANGUAGE_AND_LOCALE_CODE>"
      },
      "components": [\
          {\
              "type": "body",\
              "parameters": [\
                  {\
                      "type": "text",\
                      "text": "text-string"\
                  }\
              ]\
          }\
      ]
  }
}'
```

## Step 3: Verify message was sent through the `status` webhook

MM API for WhatsApp triggers [status messages webhooks](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) for events such as sent, delivered, and read. When a message is sent via MM API for WhatsApp, the webhook payload will have `category` and `conversation.origin.type` set to `marketing_lite`.

```
\{
  "conversation": {
    "id": "<CONVERSATION_ID>",
    "origin": {
      "type": "marketing_lite"
    }
  },
  "pricing": {
    "billable": true,
    "pricing_model": "PMP",
    "category": "marketing_lite"
  }
}
```

## Geographic availability of features

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.

### European Economic Area, United Kingdom, Japan, South Korea

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](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits) are also not active in these countries, so a lack of delivery optimizations will not have any effect on message delivery.
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 be available via Business Management API and WhatsApp Manager UI ‘conversation’ metrics.

### United States

Starting Apr 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits)).
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.

### Cuba, Iran, North Korea, Syria, and three sanctioned regions in the Ukraine (Crimea, Donetsk, Luhansk):

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](https://developers.facebook.com/documentation/business-messaging/whatsapp/support#country-restrictions).

### Russia

Starting June 20, 2025, businesses in Russia will be able to use MM API for WhatsApp with the following feature exceptions:

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.
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.
All other features of MM API for WhatsApp continue to be available.

## Learn more

Learn about additional [marketing message formats](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates)

Did you find this page helpful?

![Thumbs up icon](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)

![Thumbs down icon](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

ON THIS PAGE

Requirements

Step 1: Accept Terms of Service

Step 2: Send a marketing template message

Step 3: Verify message was sent through the status webhook

Geographic availability of features

European Economic Area, United Kingdom, Japan, South Korea

United States

Cuba, Iran, North Korea, Syria, and three sanctioned regions in the Ukraine (Crimea, Donetsk, Luhansk):

Russia

Learn more

***