Secondary Receivers List API Reference

To use the Handover Protocol, the Graph API version should be set to 2.6 or greater.

Part of the Handover Protocol, the Secondary Receivers List API allows the Primary Receiver app to retrieve the list of apps that are Secondary Receivers for a page. Only the app with the Primary Receiver role for the page may use this API.

Contents

Request URI

https://graph.facebook.com/v2.6/me/secondary_receivers?fields=id,name&access_token=<PAGE_ACCESS_TOKEN>

Example Request

To retrieve the list of Secondary Receivers, send a GET request to

curl -X GET "https://graph.facebook.com/v2.6/me/secondary_receivers?fields=id,name&access_token=<PAGE_ACCESS_TOKEN>"

Example Response

{
  "data":[
    {
      "id":"12345678910",
      "name":"David's Composer"
    },
    {
      "id":"23456789101",
      "name":"Messenger Rocks"
    }
  ]
}

Error Codes

For error codes see this page.