Crosspost to multiple Facebook Pages

This document shows you how you can use the Live Video API to post videos simultaneously to multiple pages.

Crossposting is not available for personal profiles, but for pages and professional profiles only. Crossposting is also available for VOD videos in addition to live videos.

How it works

To crosspost live videos to multiple pages and professional profiles, and VOD, you will need to do the following:

1. App users must be able to perform the CREATE_CONTENT task on the Page
2. App users must grant your app the following permissions using Facebook Login:
   • pages_manage_posts
   • pages_read_user_content
   • pages_manage_engagement
   • pages_show_list
   • publish_video
3. App users must establish a crossposting relationship with other Pages or professional profiles.
   • If you are building an app for your own pages, you might want to set up the crossposting relationship in your Facebook Page or professional profile settings.
4. Find Eligible Crossposting Pages

Establish a crossposting relationship

In order to crosspost to another page or professional profile, your page must send a crossposting request to a page or professional profile, and the invited page or profile must accept your request.

Step 1: Send a Crossposting Request

To send a crosspost request, send a POST request to the /<YOUR_PAGE_ID> endpoint with the following parameters:

• begin_crossposting_handshake set to an array with a comma separated list of pages where partner_page_id is set to the Page ID to which you are sending the request and allow_live set to true

curl -i -X POST "https://graph.facebook.com/v21.0<PAGE_1_ID> \
      ?begin_crossposting_handshake=[{partner_page_id:<PAGE_2_ID>,allow_live:true}]"

On success, your app receives a JSON response with success set to true.

Sample Response

{
  "success": true
}

Set allow_live to false to send a request to create a crossposting relationship wherein a Page can crosspost live videos to your Page only after your admins or editors have approved the video.

Accept a Crossposting Request

To accept a request from another page to crosspost their video to your page, send a POST request to the /<ID> endpoint with the accept_crossposting_handshake parameter set to the Page ID who sent the request and allow_live to true.

curl -X POST "https://graph.facebook.com/v21.0/<PAGE_2_ID>
    ?accept_crossposting_handshake=[{partner_page_id:<PAGE_1_ID>, allow_live:true}]"

On success, your app receives a JSON response with success set to true. The video will now be live on multiple pages.

To deny a request, set allow_live to false.

Find eligible Pages for crossposting

To find pages that your app user has permission to crosspost to, send a GET request to the /<PAGE_ID>/crosspost_whitelisted_pages endpoint with the following fields:

• allows_live_crossposts
• id
• name (optional)

curl "https://graph.facebook.com/v21.0/<PAGE_ID>/crosspost_whitelisted_pages" \
  -d "fields=id,name,allows_live_crossposts" 

On success your app will receive a list of IDs, names, and whether or not the Page is allowed to crosspost, true or false. true means the source page can post the crossposted live video directly to the target page without further authorization. false means the target page must manually post the crossposted video.

Sample Response

{
  "data": [
    {
      "id": "107738621396466",
      "name": "Crossposting Page C",
      "allows_live_crossposts": false
    },
    {
      "id": "106589754846067",
      "name": "Crossposting Page B",
      "allows_live_crossposts": true
    },
    {
      "id": "106343288214714",
      "name": "Crossposting Target X",
      "allows_live_crossposts": true,
    }
  ],
  "paging": {
    "cursors": {
      "before": "<PAGE_CURSOR>",
      "after": "<PAGE_CURSOR>"
    }
  }
}

Adding Crossposting Actions to a Live Video

Before you start

A user must be able to act on behalf of a page, and must be able to edit and update videos. That means, your app will need to have pages_manage_posts permission on behalf of your user.

Once we know which pages are available for crossposting, we can add crossposting_actions to any LiveVideo object. Each crossposting action defines whether a live video is made available for crossposting, and if it should automatically post to the target page.

The request is POST /{video-id} to update a video.

curl -i -X POST \
 "https://graph.facebook.com/v10.0/112103234301221?fields=crosspost_shared_pages,crossposted_broadcasts%7Bstatus,from%7Bname%7D%7D&access_token=${access_token}" \
 -H "Content-Type: application/json" \
 -d @- << HEREDOC
{"crossposting_actions": [
  {
    "page_id": "107738621396466",
    "action": "enable_crossposting"
  },
  {
    "page_id": "106589754846067",
    "action": "enable_crossposting_and_create_post"
  },
  {
    "page_id": "106343288214714",
    "action": "disable_crossposting"
  }
]}
HEREDOC

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/112103234301221",
  new JSONObject("{\"crossposting_actions\":\"[\\n  {\\n    \\\"page_id\\\": \\\"107738621396466\\\",\\n    \\\"action\\\": \\\"enable_crossposting\\\"\\n  },\\n  {\\n    \\\"page_id\\\": \\\"106589754846067\\\",\\n    \\\"action\\\": \\\"enable_crossposting_and_create_post\\\"\\n  },\\n  {\\n    \\\"page_id\\\": \\\"106343288214714\\\",\\n    \\\"action\\\": \\\"disable_crossposting\\\"\\n  }\\n]\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/112103234301221"
           parameters:@{ @"fields": @"crosspost_shared_pages,crossposted_broadcasts{status,from{name}}",@"crossposting_actions": @"[
  {
    "page_id": "107738621396466",
    "action": "enable_crossposting"
  },
  {
    "page_id": "106589754846067",
    "action": "enable_crossposting_and_create_post"
  },
  {
    "page_id": "106343288214714",
    "action": "disable_crossposting"
  }
]",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/112103234301221',
  'POST',
  {"fields":"crosspost_shared_pages,crossposted_broadcasts{status,from{name}}","crossposting_actions":"[\n  {\n    \"page_id\": \"107738621396466\",\n    \"action\": \"enable_crossposting\"\n  },\n  {\n    \"page_id\": \"106589754846067\",\n    \"action\": \"enable_crossposting_and_create_post\"\n  },\n  {\n    \"page_id\": \"106343288214714\",\n    \"action\": \"disable_crossposting\"\n  }\n]"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/112103234301221',
    array (
      'fields' => 'crosspost_shared_pages,crossposted_broadcasts{status,from{name}}',
      'crossposting_actions' => '[
        {
          "page_id": "107738621396466",
          "action": "enable_crossposting"
        },
        {
          "page_id": "106589754846067",
          "action": "enable_crossposting_and_create_post"
        },
        {
          "page_id": "106343288214714",
          "action": "disable_crossposting"
        }
      ]'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

These actions show the options available. The first would allow the first page (107738621396466) to crosspost the video from Creator Studio, or the API, but would not automatically crosspost the video anywhere. The second would prevent the second page (106589754846067) from crossposting the video, and the third would automatically post the video to the targeted page (106343288214714).

Example success

Returns the LiveVideo object, and we've used the crosspost_shared_pages edge to see which pages have it available, and the crossposted_broadcasts edge to see the pages where our posts have already posted.

Important Note

If any crossposting relationships have changed or are invalid, the crossposts will obviously not succeed, but no error will be thrown. That means inspecting the response for successful broadcasts is the only way to know if an action has succeded or not.

{
  "crosspost_shared_pages": {
    "data": [
      {
        "name": "Crossposting Page C",
        "id": "107738621396466"
      },
      {
        "name": "[FB Test Page] Crossposting Page B",
        "id": "106589754846067"
      }
    ]
  },
  "crossposted_broadcasts": {
    "data": [
      {
        "status": "UNPUBLISHED",
        "from": {
          "name": "[FB Test Page] Crossposting Page B",
          "id": "106589754846067"
        },
        "id": "114820814022961"
      }
    ]
  },
  "id": "112103234301221"
}

Example Error

If any crossposting_options are invalid, the entire request will fail. No crossposts will succeed.

{
  "error": {
    "message": "Fatal",
    "type": "OAuthException",
    "code": -1,
    "error_subcode": 1363103,
    "is_transient": false,
    "error_user_title": "Invalid Parameters",
    "error_user_msg": "The request does not specify valid parameters, no action has been taken.",
    "fbtrace_id": "AnI03n5n0Px-ihrZjkWMeTP"
  }
}