MEmeta
Marketing Messages

Send Marketing Template Message

Send marketing template messages using pre-approved templates. Supports optional product policy controls and message activity sharing settings.

post/{Version}/{Phone-Number-ID}/marketing_messages

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Phone-Number-ID}/marketing_messages
  • Auth
    HTTP bearer

Path parameters

Versionstring required
Example:v20.0

WhatsApp API version (e.g., v20.0)

Phone-Number-IDstring required
Example:102290129340398

WhatsApp Business Phone Number ID

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Content-Type'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data' required
Example:application/json

Media type of the request body

Request body

messaging_product'whatsapp' required

Messaging service used. Must be "whatsapp"

recipient_type'individual' required

Type of recipient. Must be "individual"

tostring required

WhatsApp ID or phone number of the message recipient

type'template' required

Type of message. Must be "template" for marketing messages

product_policy'CLOUD_API_FALLBACK' | 'STRICT'

Optional product policy setting

message_activity_sharingboolean

Optional flag to control message activity sharing

Example request

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "16315552222",
  "template": {
    "name": "TEMPLATE_NAME",
    "language": {
      "policy": "deterministic",
      "code": "en_US"
    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "image",
            "image": {
              "link": "http(s)://example.com/image.jpg"
            }
          }
        ]
      },
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "Hello {{1}}! Your order of {{2}} is confirmed for {{3}}."
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "quick_reply",
        "index": "0",
        "parameters": [
          {
            "type": "payload",
            "payload": "ORDER_DETAILS_CLICKED"
          }
        ]
      }
    ]
  },
  "product_policy": "CLOUD_API_FALLBACK",
  "message_activity_sharing": true
}

Response

Marketing message sent successfully

messaging_productstring

Example response

{
  "contacts": [
    {
      "input": "16315552222",
      "wa_id": "16315552222"
    }
  ],
  "messages": [
    {
      "id": "wamid.gBGGSFcCNEOPAgkO_KJ55r4w_ww",
      "message_status": "accepted"
    }
  ],
  "messaging_product": "whatsapp"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.