page
)messaging_account_linking
MessengerAccountLinkField
Field | Description |
---|---|
string
|
Name of the updated field |
messaging_customer_information
MessengerCustomerInformationField
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
value |
IDName
|
sender |
id
|
ID |
string
|
Name |
IDName
|
recipient |
id
|
ID |
string
|
Name |
unsigned integer
|
timestamp |
MessengerCommerceCustomerInfomationScreensData
|
messaging_customer_information |
list<MessengerCommerceCustomerInfomationScreenData>
|
screens |
string
|
the ID of the screen |
list<KeyValue:string,string>
|
the information entered by the user in the customer information screen |
string
|
Key of the pair |
string
|
Value of the pair |
group_feed
Describes comments made to Page's post in a Facebook Group.
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
value |
IDName
|
recipient |
id
|
ID |
string
|
Name |
IDName
|
from |
id
|
ID |
string
|
Name |
numeric string
|
group_id |
numeric string
|
comment_id |
numeric string
|
post_id |
int32
|
created_time |
string
|
item |
string
|
verb |
string
|
message |
string
|
field |
numeric string
|
parent_id |
messaging_handovers
MessengerHandoverField
Field | Description |
---|---|
string
|
Name of the updated field |
messaging_in_thread_lead_form_submit
MessengerLeadGenInThreadFormSubmitAckField
Field | Description |
---|---|
string
|
Name of the updated field |
message_context
MessengerMessageContextField
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
value |
MessengerParticipantID
|
sender |
numeric string
|
id |
MessengerParticipantID
|
recipient |
numeric string
|
id |
unsigned integer
|
timestamp |
object
|
message_context |
list<MessengerMessageContextDetections>
|
detections |
string
|
type |
string
|
id |
string
|
mid |
string
|
event_name |
string
|
model |
string
|
capi_standard_event |
string
|
model_name |
float
|
model_score |
int32
|
model_version |
MessengerMessageContextCustomData
|
custom_data |
string
|
currency |
float
|
value |
list<MessengerMessageContextSuggestions>
|
suggestions |
string
|
type |
string
|
id |
string
|
mid |
string
|
event_name |
string
|
model |
message_deliveries
MessengerMessageDeliveryReceiptField
Field | Description |
---|---|
string
|
Name of the updated field |
message_echoes
MessengerMessageEchoField
Field | Description |
---|---|
string
|
Name of the updated field |
message_edits
MessengerMessageEditField
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
value |
MessengerCommerceSenderData
|
sender |
IDName
|
recipient |
id
|
ID |
string
|
Name |
unsigned integer
|
timestamp |
object
|
message_edit |
string
|
mid |
string
|
text |
int32
|
num_edit |
message_reads
MessengerMessageReadReceiptField
Field | Description |
---|---|
string
|
Name of the updated field |
messages
MessengerMessagesField
Field | Description |
---|---|
string
|
Name of the updated field |
messaging_optins
MessengerNotificationMessagesOptinField
Field | Description |
---|---|
string
|
Name of the updated field |
messaging_optins
MessengerOneTimeOptinField
Field | Description |
---|---|
string
|
Name of the updated field |
otp_verification
MessengerOtpVerificationField
Field | Description |
---|---|
string
|
Name of the updated field |
messaging_policy_enforcement
MessengerPolicyField
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
value |
IDName
|
recipient |
id
|
ID |
string
|
Name |
unsigned integer
|
timestamp |
MessengerCommercePolicyData
|
policy_enforcement |
string
|
action |
string
|
reason |
messaging_postbacks
MessengerPostbackField
Field | Description |
---|---|
string
|
Name of the updated field |
message_reactions
MessengerReactionsField
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
value |
MessengerParticipantID
|
sender |
numeric string
|
id |
MessengerParticipantID
|
recipient |
numeric string
|
id |
unsigned integer
|
timestamp |
object
|
reaction |
string
|
mid |
enum
|
action |
string
|
emoji |
enum
|
reaction |
messaging_referrals
MessengerReferralField
Field | Description |
---|---|
string
|
Name of the updated field |
send_cart
MessengerSendCartField
Field | Description |
---|---|
string
|
Name of the updated field |
affiliation
Describes changes to a page's Affliation profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
attire
Describes changes to a page's Attire profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
awards
Describes changes to a page's Awards profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
bio
Describes changes to a page's Biography profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
birthday
Describes changes to a page's Birthday profile field.
Field | Description |
---|---|
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.
Field | Description |
---|---|
string
|
Name of the updated field |
enum
|
The result value. |
page_change_proposal
Data for page change proposal.
Field | Description |
---|---|
enum
|
The action of the proposal, can be created, accepted_manually, rejected_manually and accepted_automatically |
string
|
Name of the updated field |
|
The contents of the proposal |
numeric string
|
The ID of the proposal |
|
The upcoming change info of this proposal if the proposal will be automatically accepted |
numeric string
|
The ID of the upcoming change |
datetime
|
The time when the upcoming change will become effective |
enum
|
The status of the timer associated with this change |
string
|
The category of the proposed change |
string
|
The current value for this category |
string
|
The proposed value for this category |
enum
|
Indicate whether it was accepted or rejected only meaningful when the proposal is not pending |
company_overview
Describes changes to a page's Company Overview profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
string
|
The result value. |
culinary_team
Describes changes to a page's Culinary Team profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
current_location
Describes changes to a page's Current Location profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
description
Describes changes to a page's Story Description profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
email
Describes changes to a page's Email profile field.
Field | Description |
---|---|
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. Webhooks are not sent for Ad Posts, but are sent for Comments on Ad Posts. Notifications for Page likes will only be sent for Pages that have fewer than 10K likes.
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
The contents of the update |
datetime
|
edited_time |
object
|
The sender information |
numeric string
|
The ID of the sender |
string
|
The name of the sender |
|
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) |
string
|
Description of the type of a status update. |
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) |
datetime
|
The time the post was last updated, which occurs when a user comments on the post. |
uri
|
The permanent static URL to the post on www.facebook.com. Example: https://www.facebook.com/FacebookforDevelopers/posts/10153449196353553 |
bool
|
Whether the post is hidden or not |
string
|
The link to attached content |
string
|
The message that is part of the content |
string
|
The link to an attached photo |
list<id>
|
The IDs of the photos that were added to an album |
list<string>
|
The links to any attached photos |
token with structure: Post ID
|
The post ID |
string
|
The story—only logged for a milestone item |
string
|
The title—only logged for a milestone item |
string
|
The link to an attached video |
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) |
string
|
The type of action taken |
id
|
The album ID |
string
|
The comment ID |
datetime
|
The timestamp of when the object was created |
string
|
The ID of the event, if the feed post is an event creation story |
enum {album, address, comment, connection, coupon, event, experience, group, group_message, interest, 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 |
id
|
The ID of the open graph object |
token with structure: Post ID
|
The parent ID |
id
|
The photo ID |
string
|
The type of the user reaction |
int32
|
Whether the post is published |
id
|
The recipient ID |
id
|
The share ID |
enum {add, block, edit, edited, delete, follow, hide, mute, remove, unblock, unhide, update}
|
The type of action taken |
id
|
The video ID |
founded
Describes changes to a page's Founded profile field. This is different from the Start Date field.
Field | Description |
---|---|
string
|
Name of the updated field |
string
|
The result value. |
general_info
Describes changes to a page's General Information profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
string
|
The result value. |
general_manager
Describes changes to a page's General Manager profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
hometown
Describes changes to a page's Homewtown profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
hours
Describes changes to a page's Hours profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
inbox_labels
PageInboxLabelsField
invoice_access_invoice_draft_change
PageInvoiceAccessInvoiceDraftChangeField
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
value |
integer
|
page_id |
integer
|
invoice_id |
string
|
external_invoice_id |
object
|
updates |
object
|
shipping_address |
McomInvoiceShippingAddress
|
previous_value |
McomInvoiceContactInfo
|
contact_info |
string
|
name |
string
|
phone_number |
McomInvoiceAddressDetails
|
address_details |
string
|
country |
string
|
address_line_1 |
string
|
address_line_2 |
string
|
administrative_area |
string
|
subadministrative_area |
string
|
locality |
string
|
sublocality |
string
|
postal_code |
McomInvoiceShippingAddress
|
new_value |
McomInvoiceContactInfo
|
contact_info |
string
|
name |
string
|
phone_number |
McomInvoiceAddressDetails
|
address_details |
string
|
country |
string
|
address_line_1 |
string
|
address_line_2 |
string
|
administrative_area |
string
|
subadministrative_area |
string
|
locality |
string
|
sublocality |
string
|
postal_code |
object
|
payments |
list<P2MInvoicePayment>
|
previous_value |
McomInvoiceCurrencyInfo
|
payment_amount |
string
|
currency |
string
|
amount |
string
|
payment_method |
string
|
buyer_id |
string
|
order_id |
string
|
payment_id |
integer
|
creation_time |
P2MInvoicePaymentMetadata
|
metadata |
P2MInvoiceBankSlipMetadata
|
bank_slip |
string
|
image_url |
numeric string
|
media_id |
string
|
bank_transfer_id |
integer
|
transaction_time |
string
|
validation_status |
string
|
validation_error |
string
|
receiver_name |
string
|
receiver_bank_account_id |
string
|
receiver_bank_code |
string
|
sender_name |
string
|
sender_bank_account_id |
string
|
sender_bank_code |
list<P2MInvoicePayment>
|
new_value |
McomInvoiceCurrencyInfo
|
payment_amount |
string
|
currency |
string
|
amount |
string
|
payment_method |
string
|
buyer_id |
string
|
order_id |
string
|
payment_id |
integer
|
creation_time |
P2MInvoicePaymentMetadata
|
metadata |
P2MInvoiceBankSlipMetadata
|
bank_slip |
string
|
image_url |
numeric string
|
media_id |
string
|
bank_transfer_id |
integer
|
transaction_time |
string
|
validation_status |
string
|
validation_error |
string
|
receiver_name |
string
|
receiver_bank_account_id |
string
|
receiver_bank_code |
string
|
sender_name |
string
|
sender_bank_account_id |
string
|
sender_bank_code |
leadgen
Describes changes to a page's leadgen settings.
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
Result values. |
id
|
The ID of the ad group that the lead is part of |
id
|
The ID of the ad that the lead is part of |
datetime
|
When the lead was created |
id
|
The ID of the created lead |
id
|
The ID of the page that the lead belongs to |
id
|
The ID of the form that the lead is part of |
live_videos
Describes changes to a page's live video status.
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
Content of the update |
id
|
The ID of the live video |
enum
|
The status of the live video |
location
Describes changes to a page's Location profile field, including the street address, city/state, or zip code fields.
Field | Description |
---|---|
string
|
Name of the updated field |
members
Describes changes to a page's Members profile field.
Field | Description |
---|---|
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.
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
The contents of the update |
object
|
The sender information. Only availabe for Workplace community |
numeric string
|
The ID of the sender |
string
|
The name of the sender |
string
|
The attachement link in the content that mentioned the page |
string
|
The message that is part of the content that mentioned the page |
|
Profiles tagged in the message. Workplace only apps |
numeric string
|
ID of the profile |
unsigned int32
|
Number of characters in the text indicating the object |
string
|
Name of the object |
unsigned int32
|
The character offset in the source text of the text indicating the object |
enum {user, page, event, group, application}
|
Type of the object |
string
|
The link to an attached photo in the content that mentioned the page |
list<string>
|
The links to attached photos in the content that mentioned the page |
token with structure: Post ID
|
The ID of the post that mentioned the page |
string
|
The link to an attached video in the content that mentioned the page |
string
|
The type of action taken |
id
|
The album ID |
string
|
The comment ID |
datetime
|
The timestamp of when the object was created |
string
|
The ID of the event, if the feed post is an event creation story |
enum {album, address, comment, connection, coupon, event, experience, group, group_message, interest, 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 |
id
|
The ID of the open graph object |
token with structure: Post ID
|
The parent ID |
id
|
The photo ID |
string
|
The type of the user reaction |
int32
|
Whether the post is published |
id
|
The recipient ID |
id
|
The share ID |
enum {add, block, edit, edited, delete, follow, hide, mute, remove, unblock, unhide, update}
|
The type of action taken |
id
|
The video ID |
mission
Describes changes to a page's Mission profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
string
|
The result value. |
name
Describes changes to a page's Name profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
string
|
The page's name |
page_about_story
PagePageAboutStoryField
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
The result values. |
integer
|
Id of the page that the mutated page about story belongs to. |
integer
|
Id of the page about story. |
parking
Describes changes to a page's Parking profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
payment_options
Describes change to a page's Payment profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
personal_info
Describes changes to a page's Personal Information profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
personal_interests
Describes changes to a page's Personal Interests profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
phone
Describes changes to a page's Phone profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
picture
Describes changes to a page's profile picture.
Field | Description |
---|---|
string
|
Name of the updated field |
price_range
Describes changes to a page's Price Range profile field.
Field | Description |
---|---|
string
|
Name of the updated field |
product_review
Describes changes to a page's product review settings.
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
The result values. |
id
|
The Product Item ID that this review is about |
enum {NO_REVIEW, PENDING, REJECTED, APPROVED, OUTDATED}
|
The review status |
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.
Field | Description |
---|---|
string
|
Name of the updated field |
string
|
The result value. |
public_transit
Describes changes to a page's Public Transit profile field.
Field | Description |
---|---|
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.
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
The result values. |
string
|
The Comment ID if a comment was made on a rating |
datetime
|
Timestamp for when the action took place |
enum
|
The type of object that was updated |
string
|
The Comment message if a comment was made on a rating |
id
|
Open Graph story ID of this rating for added or edited ratings |
token with structure: Post ID
|
The parent object ID, which can be the rating object or another comment |
string
|
The Photo URI if a photo was attached to a comment on a rating |
token with structure: Post ID
|
The Post ID of the rating |
int32
|
The star rating on created or edited ratings |
(string) or (null)
|
The Review text on created or edited ratings |
string
|
The user's reaction type, if the user selects a reaction for a rating |
enum
|
Whether or not this recommendation was "positive" or "negative" |
id
|
The ID of the reviewer on created or edited ratings |
string
|
The name of reviewer on created or edited ratings |
id
|
The ID of the user or page taking an action on a rating |
string
|
The name of the user or page taking an action on a rating |
enum {add, block, edit, edited, delete, follow, hide, mute, remove, unblock, unhide, update}
|
The type of action taken on a rating |
page_upcoming_change
Webhooks data for page upcoming changes.
Field | Description |
---|---|
enum
|
The action happened for this upcoming change |
string
|
Name of the updated field |
|
The contents of the upcoming change |
|
The associated page of this upcoming change |
string
|
The name of the Page |
datetime
|
The time when the upcoming change will become effective |
enum
|
The type of the upcoming change |
enum
|
The status of the timer associated with this change |
|
The proposal associated with the change, only valid when change_type is knowledge_proposal |
string
|
The category of the proposed change |
enum
|
Indicate whether it was accepted or rejected only meaningful when the proposal is not pending |
string
|
The current value for this category |
string
|
The proposed value for this category |
videos
Describes changes to the encoding status of a video on a page.
Field | Description |
---|---|
string
|
Name of the updated field |
object
|
Content of the update |
id
|
ID of the video |
object
|
Status of the video |
enum
|
Status of the video |
website
Describes changes to a page's Website profile field.
Field | Description |
---|---|
string
|
Name of the updated field |