Graph API Version

Page (page)

Full list of page profile fields you can subscribe to. Fields of this topic require at least one page admin to grant the 'manage_pages' permission to your app. The page admin also needs to have at least moderator privileges in order to receive all content.

affiliation

Describes changes to a page's Affliation profile field.

Fields

FieldDescription

field

string

Name of the updated field

attire

Describes changes to a page's Attire profile field.

Fields

FieldDescription

field

string

Name of the updated field

awards

Describes changes to a page's Awards profile field.

Fields

FieldDescription

field

string

Name of the updated field

bio

Describes changes to a page's Biography profile field.

Fields

FieldDescription

field

string

Name of the updated field

birthday

Describes changes to a page's Birthday profile field.

Fields

FieldDescription

field

string

Name of the updated field

category

Describes changes to a page's Category field. There can be up to three categories describing a page's topic, business, or person.

Fields

FieldDescription

field

string

Name of the updated field

value

enum

The result value.

checkins

Page check-ins have been deprecated, so this field no longer describes newly created check-ins at the page's location. Instead, it will only send a notification when an existing check-in gets deleted.

Fields

FieldDescription

field

string

Name of the updated field

company_overview

Describes changes to a page's Company Overview profile field.

Fields

FieldDescription

field

string

Name of the updated field

value

string

The result value.

conversations

Describes changes in conversation threads involving a page.

Fields

FieldDescription

field

string

Name of the updated field

value

object

Result values

page_id

integer

The ID of the page involved in the conversation

thread_id

string

The ID of the conversation

scoped_thread_key

string

The new recommended identifier for threads

culinary_team

Describes changes to a page's Culinary Team profile field.

Fields

FieldDescription

field

string

Name of the updated field

current_location

Describes changes to a page's Current Location profile field.

Fields

FieldDescription

field

string

Name of the updated field

description

Describes changes to a page's Story Description profile field.

Fields

FieldDescription

field

string

Name of the updated field

email

Describes changes to a page's Email profile field.

Fields

FieldDescription

field

string

Name of the updated field

feed

Describes nearly all changes to a Page's feed, such as Posts, shares, likes, etc. The values received depend on the types of changes made to the Page's feed. Note that Webhooks does not return Ad Posts and the Comments associated with them in the feed subscription or the /page/feed results. Notifications for Page likes will only be sent for Pages that have fewer than 10K likes.

Fields

FieldDescription

field

string

Name of the updated field

value

object

The contents of the update

edited_time

datetime

edited_time

from

object

The sender information

id

numeric string

The ID of the sender

name

string

The name of the sender

post

Post

Provide additional content about a post such as 'type' (e.g. photo, video), 'status_type' (e.g. added_photos), 'is_published' (e.g. true/false), 'updated_time', 'permalink_url', 'promotion_status' (e.g. inactive, extendable)

status_type

string

Description of the type of a status update.

is_published

bool

Indicates whether a scheduled post was published (applies to scheduled Page Post only, for users post and instanlty published posts this value is always true)

updated_time

datetime

The time the post was last updated, which occurs when a user comments on the post, expressed as a UNIX timestamp

permalink_url

uri

The permanent static URL to the post on www.facebook.com. Example: https://www.facebook.com/FacebookforDevelopers/posts/10153449196353553

is_hidden

bool

Whether the post is hidden or not

link

string

The link to attached content

message

string

The message that is part of the content

photo

string

The link to an attached photo

photo_ids

list<id>

The IDs of the photos that were added to an album

photos

list<string>

The links to any attached photos

post_id

token with structure: Post ID

The post ID

story

string

The story—only logged for a milestone item

title

string

The title—only logged for a milestone item

video

string

The link to an attached video

video_flag_reason

int32

The code why the video is flagged. Available when a video is blocked, muted, or unblocked. (Reason Code 1: Your video may contain content that belongs to someone else)

action

string

action

album_id

id

album_id

comment_id

string

comment_id

created_time

datetime

created_time

event_id

string

event_id

item

enum {album, address, comment, connection, coupon, event, experience, group, group_message, interest, like, link, mention, milestone, note, page, picture, platform-story, photo, photo-album, post, profile, question, rating, reaction, relationship-status, share, status, story, timeline cover, tag, video}

item

open_graph_story_id

id

open_graph_story_id

parent_id

token with structure: Post ID

parent_id

photo_id

id

photo_id

reaction_type

string

reaction_type

published

int32

published

recipient_id

id

recipient_id

share_id

id

share_id

verb

enum {add, block, edit, edited, delete, follow, hide, mute, remove, unblock, unhide, update}

verb

video_id

id

video_id

founded

Describes changes to a page's Founded profile field. This is different from the Start Date field.

Fields

FieldDescription

field

string

Name of the updated field

value

string

The result value.

general_info

Describes changes to a page's General Information profile field.

Fields

FieldDescription

field

string

Name of the updated field

value

string

The result value.

general_manager

Describes changes to a page's General Manager profile field.

Fields

FieldDescription

field

string

Name of the updated field

hometown

Describes changes to a page's Homewtown profile field.

Fields

FieldDescription

field

string

Name of the updated field

hours

Describes changes to a page's Hours profile field.

Fields

FieldDescription

field

string

Name of the updated field

leadgen

Describes changes to a page's leadgen settings.

Fields

FieldDescription

field

string

Name of the updated field

value

object

Result values.

email_hash

(string) or (null)

The SHA256 hash of the email associated with the lead

ad_id

id

The ID of the ad that the lead is part of

form_id

id

The ID of the form that the lead is part of

leadgen_id

id

The ID of the created lead

created_time

datetime

When the lead was created

page_id

id

The ID of the page that the lead belongs to

adgroup_id

id

The ID of the ad group that the lead is part of

location

Describes changes to a page's Location profile field, including the street address, city/state, or zip code fields.

Fields

FieldDescription

field

string

Name of the updated field

members

Describes changes to a page's Members profile field.

Fields

FieldDescription

field

string

Name of the updated field

mention

Describes new mentions of a page, including mentions in comments, posts, etc. Some comment_id and post_id fields returned in mention webhooks may not be queried due to missing permissions including privacy issues.

Fields

FieldDescription

field

string

Name of the updated field

value

object

The contents of the update

community

Workplace community which this group belongs to. Workplace only apps

id

numeric string

The Group ID

from

object

The sender information. Only availabe for Workplace community

id

numeric string

The ID of the sender

name

string

The name of the sender

link

string

The attachement link in the content that mentioned the page

message

string

The message that is part of the content that mentioned the page

message_tags

Profiles tagged in the message. Workplace only apps

id

numeric string

ID of the profile

length

unsigned int32

Number of characters in the text indicating the object

name

string

Name of the object

offset

unsigned int32

The character offset in the source text of the text indicating the object

type

enum {user, page, event, group, application}

Type of the object

photo

string

The link to an attached photo in the content that mentioned the page

photos

list<string>

The links to attached photos in the content that mentioned the page

post_id

token with structure: Post ID

The ID of the post that mentioned the page

video

string

The link to an attached video in the content that mentioned the page

action

string

The type of action taken

album_id

id

The album ID

comment_id

string

The ID of the comment that mentioned the page

created_time

datetime

The timestamp when the page was mentioned

event_id

string

The ID of the event, if the feed post is an event creation story

item

enum {album, address, comment, connection, coupon, event, experience, group, group_message, interest, like, link, mention, milestone, note, page, picture, platform-story, photo, photo-album, post, profile, question, rating, reaction, relationship-status, share, status, story, timeline cover, tag, video}

The type of item

open_graph_story_id

id

The ID of the open graph object

parent_id

token with structure: Post ID

The parent ID

photo_id

id

The photo ID

reaction_type

string

The type of the user reaction

published

int32

Whether the post is published

recipient_id

id

The recipient ID

share_id

id

The share ID

verb

enum {add, block, edit, edited, delete, follow, hide, mute, remove, unblock, unhide, update}

The type of action taken

video_id

id

The video ID

merchant_review

Describes changes to a page's merchant review settings.

Fields

FieldDescription

field

string

Name of the updated field

value

object

The result values.

merchant_settings_id

id

The Merchant Settings ID that this review is about

status

enum

The review status

reasons

list<string>

A list of reasons why the merchant was rejected. Only set if the status is not ENABLED.

reason_messages

list<string>

A list of messages describing every reason

mission

Describes changes to a page's Mission profile field.

Fields

FieldDescription

field

string

Name of the updated field

value

string

The result value.

name

Describes changes to a page's Name profile field.

Fields

FieldDescription

field

string

Name of the updated field

value

string

The page's name

page_about_story

PagePageAboutStoryField

Fields

FieldDescription

field

string

Name of the updated field

value

object

The result values.

page_id

integer

Id of the page that the mutated page about story belongs to.

page_about_story_id

integer

Id of the page about story.

parking

Describes changes to a page's Parking profile field.

Fields

FieldDescription

field

string

Name of the updated field

payment_options

Describes change to a page's Payment profile field.

Fields

FieldDescription

field

string

Name of the updated field

personal_info

Describes changes to a page's Personal Information profile field.

Fields

FieldDescription

field

string

Name of the updated field

personal_interests

Describes changes to a page's Personal Interests profile field.

Fields

FieldDescription

field

string

Name of the updated field

phone

Describes changes to a page's Phone profile field.

Fields

FieldDescription

field

string

Name of the updated field

picture

Describes changes to a page's profile picture.

Fields

FieldDescription

field

string

Name of the updated field

price_range

Describes changes to a page's Price Range profile field.

Fields

FieldDescription

field

string

Name of the updated field

product_review

Describes changes to a page's product review settings.

Fields

FieldDescription

field

string

Name of the updated field

value

object

The result values.

product_item_id

id

The Product Item ID that this review is about

status

enum {NO_REVIEW, PENDING, REJECTED, APPROVED, OUTDATED}

The review status

reasons

list<string>

A list of reasons why the product item was rejected. Only set if the status is REJECTED.

products

Describes changes to a page's Products profile field.

Fields

FieldDescription

field

string

Name of the updated field

value

string

The result value.

public_transit

Describes changes to a page's Public Transit profile field.

Fields

FieldDescription

field

string

Name of the updated field

ratings

Describes changes to a page's ratings, including new ratings or a user's comments or reactions on a rating.

Fields

FieldDescription

field

string

Name of the updated field

value

object

The result values.

comment_id

(string) or (null)

The Comment ID if a comment was made on a rating

created_time

datetime

Timestamp for when the action took place

item

enum

The type of object that was updated

message

string

The Comment message if a comment was made on a rating

open_graph_story_id

id

Open Graph story ID of this rating for added or edited ratings

parent_id

token with structure: Post ID

The parent object ID, which can be the rating object or another comment

photo

string

The Photo URI if a photo was attached to a comment on a rating

post_id

token with structure: Post ID

The Post ID of the rating

rating

int32

The star rating on created or edited ratings

review_text

(string) or (null)

The Review text on created or edited ratings

reaction_type

string

The user's reaction type, if the user selects a reaction for a rating

recommendation_type

enum

Whether or not this recommendation was "positive" or "negative"

reviewer_id

id

The ID of the reviewer on created or edited ratings

reviewer_name

string

The name of reviewer on created or edited ratings

sender_id

id

The ID of the user or page taking an action on a rating

sender_name

string

The name of the user or page taking an action on a rating

verb

enum {add, block, edit, edited, delete, follow, hide, mute, remove, unblock, unhide, update}

The type of action taken on a rating

registration

Represents the user who registers with publishers with regiwall

Fields

FieldDescription

field

string

Name of the updated field

value

object

The result values

registration_first_name

string

The first name the user use to register

registration_last_name

string

The last name the user use to register

registration_email

string

The email the user use to register

videos

Describes changes to the encoding status of a video on a page.

Fields

FieldDescription

field

string

Name of the updated field

value

object

Content of the update

id

id

ID of the video

status

object

Status of the video

video_status

enum

Status of the video

website

Describes changes to a page's Website profile field.

Fields

FieldDescription

field

string

Name of the updated field