Page Upcoming Changes API

This document explains how to use the Page Upcoming Changes API to view and accept or reject changes suggested by Facebook to fix possible errors on your Facebook Page.

Before You Start

You will need:

• the pages_manage_metadata permission
• a Page access token requested by a person who is able to perform the MODERATE task on the Page that is being queried

Get Proposed Changes

Send a GET request to the /{page-id}:

curl -i -X GET "https://graph.facebook.com/{page-id}
    ?access_token={page-access-token}"

On success, your app receives the following response:

{
  "data": [
    {
      "id": "{proposed-change-1-id}", 
      "page": {
        "name": "My Page",
        "id": "{page-id}"   
      },
      "effective_time": "2017-10-16T10:19:49 0000",
      "timer_status": "stopped",           //this proposal was accepted or rejected
      "change_type": "knowledge_proposal",
      "proposal": {
        "id": "1570719759662530",
        "category": "category",
        "current_value": "273819889375819, 161516070564222, 152142351517013",
        "proposed_value": "273819889375819, 161516070564222, 152142351517013, 273819889375819"
      }
    },
    {
      "id": "{proposed-change-2-id}",
      "page": {
        "name": "My Page",
        "id": "{page-id}"
      },
      "effective_time": "2017-11-21T07:03:54 0000",
      "timer_status": "already_fired",   //this proposal was automatically accepted
      "change_type": "knowledge_proposal",
      "proposal": {
        "id": "1603101113091061",
        "category": "category",
        "current_value": "273819889375819, 161516070564222, 152142351517013",
        "proposed_value": "273819889375819, 161516070564222, 152142351517013, 273819889375819",
        "acceptance_status": "accepted"
      }
    }
  ]
}

Accept or Reject a Proposed Change

Send a POST request to the /{proposal-id} endpoint with the accept field set to true to accept the change or false to reject it:

curl -i -X POST "https://graph.facebook.com/{proposal-id}
     ?accept=true
     &access_token={page-access-token}"

On success, your app receives the following response:

{
  "succeed": true
}

Page Change Webhooks

Subscribe to the page_upcoming_change and/or the page_change_proposal.

Your callback URL will receive the following notification for the page_upcoming_change webhook:

{
  "field": "page_upcoming_change",
  "action": "pending", // can also be accepted_manually, accepted_automatically and rejected_manually
  "value": {
    "id": "123456", // id of upcoming change
    "page": {
      "id": "7878832", // id of page where the action is taken
      "name": "Page Name"
    },
    "effective_time": "2017-03-01 12:00:00",
    "change_type": "knowledge_proposal",
    "timer_status": "active",
    "proposal": {
      "id": "id of the page change proposal",
      "category": "menu link",
      "acceptance_status": "pending", // can also be accepted or rejected
      "current_value": "https://www.oldmenu.com/",
      "proposed_value": "https://www.newmenu.com/"
    }
  }
}

Your callback URL will receive the following notification for the page_change_proposal webhook:

{
  "field": "page_change_proposal",
  "action": "created",
  "value": {
    "id": "{change-proposal-id}",
    "category": "menu link",
    "current_value": "https://www.menuold.com/",
    "proposed_value": "https://www.menunew.com/",
    "acceptance_status": "pending"
  }
}

Reference

Webhooks

Page Change Proposal Categories

A Page Change Proposal is a change proposed for your Page. It contains information such as category, the current page value, and the proposed value.

See Also

• Page Upcoming Change Reference Guide