Sponsored Messages Reference

The sponsored_message_ads endpoint gives you the ability to send sponsored messages, which are a type of paid ad that is sent directly to everyone who currently has an open chat with your Facebook Page. The sponsored_message_ads endpoint is an interface for using the sponsored message feature of the Facebook Marketing API. Note that the instructions within Facebook Marketing API show a slightly different way that achieves the same result.

For more information on using the sponsored_message_ads endpoint, see Sending Sponsored Messages.

Contents

• Request URI
• Example Request
• Properties
  • Create Message Creative
  • Send Sponsored Message
• Response

Request URI

Create Message Creative

https://graph.facebook.com/v2.11/me/message_creatives?access_token=<PAGE_ACCESS_TOKEN>

Send Sponsored Message

https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/sponsored_message_ads

Example Request

Create Message Creative

curl -X POST -H "Content-Type: application/json" -d '{    
  "messages": [  
    {
      "dynamic_text": {
          "text": "Hi, {first_name}! Here is a message",
          "fallback_text": "Hi! Here is a message"
      }       
    }
  ]
}' "https://graph.facebook.com/v3.3/me/message_creatives?access_token=<PAGE_ACCESS_TOKEN>"

Send Sponsored Message

  curl \
  -F 'message_creative_id=938461089' \
  -F 'daily_budget=100' \
  -F 'bid_amount=400' \
  -F "targeting={'geo_locations': {'countries':['US']}}" \
  -F 'access_token=<USER_ACCESS_TOKEN>' \
  "https://graph.facebook.com/v3.3/act_<AD_ACCOUNT_ID>/sponsored_message_ads"

Properties

Create Message Creative

Send Sponsored Message

Response

Create Message Creative

{
  "message_creative_id": 938461089,
}

Send Sponsored Message

{
  "ad_group_id": "6088387928148",
  "broadcast_id": "754911018029273",
  "success": true
}