Messenger Profile API

Messenger Profile is the central store for your bot's properties.

Through this API, you can access the following:

* = Supports localization. See docs for more info.

Accessing Profile Multiple Properties at Once

The documentation above shows more on how each of these individual properties work, but you should also know that you can access multiple properties with a single call.

Setting Messenger Profile

You can set multiple Messenger Profile properties at the same time by making one POST call to /me/messenger_profile?access_token=PAGE_ACCESS_TOKEN with the property names and their new settings in the body of the request.

Properties in the POST request body will be overwritten while other properties will remain untouched.

The following sample request will only override the existing settings of Account Linking URL, Persistent Menu, and Target Audience:

curl -X POST -H "Content-Type: application/json" -d '{
  "account_linking_url": "ACCOUN_LINKING_URL",
  "persistent_menu": {
    PERSISTENT_MENU_SETTINGS
  },
  "target_audience": {
    TARGET_AUDIENCE_SETTINGS
  }
}' "https://graph.facebook.com/v2.6/me/messenger_profile?access_token=PAGE_ACCESS_TOKEN"

Reading Messenger Profile

You can read multiple Messenger Profile properties at the same time by making one GET call to /me/messenger_profile?fields=PROPERTIES&access_token=PAGE_ACCESS_TOKEN. The following sample request will return the settings of Account Linking URL, Persistent Menu, and Target Audience in the response.

curl -X GET "https://graph.facebook.com/v2.6/me/messenger_profile?fields=account_linking_url,persistent_menu,target_audience&access_token=PAGE_ACCESS_TOKEN"

Deleting Messenger Profile

You can delete multiple Messenger Profile properties at the same time by making one DELETE call to /me/messenger_profile?access_token=PAGE_ACCESS_TOKEN with the property names in the body.

Properties in the DELETE request body will be deleted while other properties will remain untouched. The following sample request will only delete the existing settings of Account Linking URL, Persistent Menu, and Target Audience.

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "account_linking_url",
    "persistent_menu",
    "target_audience"
  ]
}' "https://graph.facebook.com/v2.6/me/messenger_profile?access_token=PAGE_ACCESS_TOKEN""