---
url: >-
  https://docs.corbitaltech.dev/products/whatsmark-saas/tenant/marketing-messages-api.md
description: >-
  How WhatsMark sends marketing templates through Meta's Marketing Messages API
  for WhatsApp (MM Lite), how to check your onboarding status, accept Meta's
  terms, and use the optional Messaging account ID.
---

# Marketing Messages API 

The Marketing Messages API (also called **MM Lite**) is a Meta service for sending marketing templates. Meta uses it to deliver your marketing messages to the people most likely to read them.

WhatsMark uses it automatically. You do not need to change your templates, phone number or campaigns.

::: info Nothing changes until you accept Meta's terms
Until you accept Meta's terms, your marketing messages are sent through the regular WhatsApp Cloud API, as before.
:::

## Which Messages Use It

Only templates in the **Marketing** category use the Marketing Messages API. Utility and Authentication templates, and normal chat replies, are not affected.

| Template category  | Sent through               |
| ------------------ | -------------------------- |
| **Marketing**      | Marketing Messages API     |
| **Utility**        | Regular WhatsApp Cloud API |
| **Authentication** | Regular WhatsApp Cloud API |

## Check Your Status

Go to **Connect WABA**. The **Marketing Messages API** card shows your status.

![Marketing Messages API status card](../images/marketing-messages-api/status-card.png)

| Status                       | What it means                                                                                  |
| ---------------------------- | ---------------------------------------------------------------------------------------------- |
| **Onboarded**                | You have accepted Meta's terms. Your marketing templates use the Marketing Messages API.       |
| **Eligible - action needed** | You can use it, but you have not accepted Meta's terms yet. Follow the steps below.            |
| **Access token invalid**     | Meta rejected your saved access token. Reconnect your account, then click **Refresh status**.  |
| **Not checked yet**          | Click **Refresh status** to check now.                                                         |

WhatsMark updates the status automatically after you connect, after you accept the terms, and once a day. Click **Refresh status** to update it right away.

## Accept Meta's Terms

To use the Marketing Messages API, Meta needs you to accept its terms. You do this in Meta's **WhatsApp Manager**, not in WhatsMark. You only need to do it once for each WhatsApp Business Account.

**Who can do this:** only an admin with **full control** of your Meta business portfolio. If that is not you, ask the person who owns your Meta business account.

### Step 1: Open WhatsApp Manager

On the Marketing Messages API card in WhatsMark, click **Open WhatsApp Manager**. You can also open [WhatsApp Manager → Overview](https://business.facebook.com/latest/whatsapp_manager/overview) yourself. Log in to Meta if asked.

### Step 2: Accept the terms

On the **Overview** page, scroll to the **Alerts** section. Find the alert for the **Marketing Messages API for WhatsApp** and click **Accept terms**. Read the terms and confirm.

If you do not see the alert, the terms may already be accepted, or your account may not be eligible yet.

### Step 3: Refresh the status in WhatsMark

Go back to WhatsMark and click **Refresh status** on the card. Meta can take a few minutes to update, so if the status has not changed, wait a moment and try again.

The card now shows **Onboarded**. You do not need a new phone number or new templates.

![Status card showing Onboarded](../images/marketing-messages-api/onboarded-status.png)

## Block Marketing Templates on Cloud API

After you are **Onboarded**, you will see a switch called **Block marketing templates on Cloud API**.

When you turn it on, marketing messages can only be sent through the Marketing Messages API. Any other way of sending them is stopped. Your WhatsMark marketing messages keep working normally.

![Block marketing templates on Cloud API switch](../images/marketing-messages-api/block-cloud-api-switch.png)

## Turned Off by the Administrator

Sometimes the card says the administrator has turned off the Marketing Messages API. Your marketing messages are still sent as normal. To use the Marketing Messages API, contact your administrator.

![Turned off by the administrator message](../images/marketing-messages-api/turned-off-by-admin.png)

## Messaging Account ID (Optional)

**Most accounts do not need this. Leave it blank.**

### When do you need it?

Only when Meta rejects your messages from a phone number because your account has more than one Messaging account. In that case, you tell WhatsMark which Messaging account to send from. WhatsMark then sends this ID with every message from that number.

### Where to use it

1. Go to **Connect WABA**.
2. In the **Phone** card, click **Messaging account ID** (next to **Manage Phone Numbers**).
3. Enter the ID (digits only) and click **Save**.

![Messaging account ID button and window](../images/marketing-messages-api/messaging-account-id.png)

Only the main account owner can see this button.

### Where to get the ID

Copy the ID of the Messaging account you want to use from Meta's **WhatsApp Manager**, then paste it into the window above.

### How to remove it

Open the same window, clear the field and click **Save**.