Facebook

Connect a Facebook account to manage Pages: posts, comments, messages, insights, and ads.

Connection

• Auth type: oauth2

Scopes requested:

• pages_show_list
• pages_read_engagement
• pages_read_user_content
• pages_manage_posts
• pages_manage_engagement
• pages_manage_metadata
• pages_messaging
• read_insights
• business_management
• ads_read
• ads_management

Actions

Action	Key	Group	Side effect	Risk	Approval
Get Page details	facebook.get_page_details	Pages	NONE	low	no
Get Page insights	facebook.get_page_insights	Pages	NONE	low	no
Get Page photos	facebook.get_page_photos	Pages	NONE	low	no
Get Page posts	facebook.get_page_posts	Pages	NONE	low	no
Get Page videos	facebook.get_page_videos	Pages	NONE	low	no
Get Page roles	facebook.get_page_roles	Pages	NONE	low	no
Get tagged posts	facebook.get_page_tagged_posts	Pages	NONE	low	no
List Page stories	facebook.list_page_stories	Pages	NONE	low	no
Search Pages	facebook.search_pages	Pages	NONE	low	no
List video thumbnails	facebook.list_video_thumbnails	Pages	NONE	low	no
Update Page settings	facebook.update_page_settings	Pages	WRITE	high	yes
Assign Page tasks	facebook.assign_page_task	Pages	WRITE	high	yes
Remove Page tasks	facebook.remove_page_task	Pages	WRITE	high	yes
List managed Pages	facebook.list_managed_pages	Pages	NONE	low	no
Get post	facebook.get_post	Posts	NONE	low	no
Get post insights	facebook.get_post_insights	Posts	NONE	low	no
Get post reactions	facebook.get_post_reactions	Posts	NONE	low	no
Get scheduled posts	facebook.get_scheduled_posts	Posts	NONE	low	no
Create post	facebook.create_post	Posts	WRITE	high	yes
Create photo post	facebook.create_photo_post	Posts	WRITE	high	yes
Update post	facebook.update_post	Posts	WRITE	high	yes
Delete post	facebook.delete_post	Posts	WRITE	high	yes
Publish scheduled post now	facebook.publish_scheduled_post	Posts	WRITE	high	yes
Reschedule post	facebook.reschedule_post	Posts	WRITE	medium	no
Refresh URL preview	facebook.refresh_url_scrape	Posts	WRITE	low	no
Create multi-photo post	facebook.create_multi_photo_post	Posts	WRITE	high	yes
Create video post	facebook.create_video_post	Posts	WRITE	high	yes
Upload photos in batch	facebook.upload_photos_batch	Posts	WRITE	high	yes
Get comment	facebook.get_comment	Comments	NONE	low	no
Get comments	facebook.get_comments	Comments	NONE	low	no
Create comment	facebook.create_comment	Comments	WRITE	high	yes
Update comment	facebook.update_comment	Comments	WRITE	medium	no
Delete comment	facebook.delete_comment	Comments	WRITE	high	yes
Like post or comment	facebook.like_post_or_comment	Comments	WRITE	low	no
Unlike post or comment	facebook.unlike_post_or_comment	Comments	WRITE	low	no
Get Page conversations	facebook.get_page_conversations	Messenger	NONE	low	no
Get conversation messages	facebook.get_conversation_messages	Messenger	NONE	low	no
Get message details	facebook.get_message_details	Messenger	NONE	low	no
Send Messenger text message	facebook.send_message	Messenger	WRITE	high	yes
Send Messenger media message	facebook.send_media_message	Messenger	WRITE	high	yes
Mark message seen	facebook.mark_message_seen	Messenger	WRITE	low	no
Toggle typing indicator	facebook.toggle_typing_indicator	Messenger	WRITE	low	no
List granted permissions	facebook.list_permissions	Business and ads	NONE	low	no
List businesses	facebook.list_businesses	Business and ads	NONE	low	no
List business-owned Pages	facebook.list_owned_pages	Business and ads	NONE	low	no
List business client Pages	facebook.list_client_pages	Business and ads	NONE	low	no
List ad accounts	facebook.list_ad_accounts	Business and ads	NONE	low	no
List business-owned ad accounts	facebook.list_owned_ad_accounts	Business and ads	NONE	low	no
List ads	facebook.list_ads	Business and ads	NONE	low	no
Get ad insights	facebook.get_ad_insights	Business and ads	NONE	low	no
Search targeting locations	facebook.search_geographic_targeting_locations	Business and ads	NONE	low	no
Get current user	facebook.get_current_user	Business and ads	NONE	low	no
Get Graph object	facebook.get_graph_object	Business and ads	NONE	low	no
Get Graph objects	facebook.get_graph_objects	Business and ads	NONE	low	no

Events

facebook.message_received

Someone sent a Messenger message to a connected Page. Echoes of the Page's own messages are skipped.

Field	Type	Description
page_id	string
sender	object
sender.id	string	Page-scoped user id (PSID)
message	object
message.mid	string
message.text	string
message.attachments	array of object
message.attachments[].type	string
message.attachments[].url	string
timestamp	integer

facebook.message_postback

Someone tapped a postback button (persistent menu, Get Started, or a button in a message) on a connected Page.

Field	Type	Description
page_id	string
sender	object
sender.id	string	Page-scoped user id (PSID)
postback	object
postback.title	string
postback.payload	string
timestamp	integer

facebook.comment_added

Someone commented on a post of a connected Page. Comments written by the Page itself are skipped.

Field	Type	Description
page_id	string
post_id	string
comment	object
comment.id	string
comment.parent_id	string
comment.message	string
comment.from	object
comment.from.id	string
comment.from.name	string
created_time	integer