Messenger
Manage conversations and send messages for Facebook Pages
OAuth42 native toolsIcon needs-review
This catalogue entry describes the current repository definition. Availability, scopes, and production readiness should be confirmed during private-beta onboarding.
Native tools
GET
messenger_list_pages
List Facebook Pages available to the connected user
/me/accounts
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_current_user
Get the authenticated Meta user
/me
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| fields | string | optional | Comma-separated fields to include |
GET
messenger_get_page
Get a Facebook Page profile
/{page_id}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
GET
messenger_get_page_details
Get a Facebook Page profile
/{page_id}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
GET
messenger_list_conversations
List Messenger conversations for a Facebook Page
/{page_id}/conversations
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| platform | string | optional | Messaging platform |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_page_conversations
List Messenger conversations for a Facebook Page
/{page_id}/conversations
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| platform | string | optional | Messaging platform |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_list_messages
List messages in a Messenger conversation
/{conversation_id}/messages
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | required | Messenger conversation ID |
| page_id | string | optional | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_conversation_messages
List messages in a Messenger conversation
/{conversation_id}/messages
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| conversation_id | string | required | Messenger conversation ID |
| page_id | string | optional | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_message_details
Get details for a Messenger message
/{message_id}
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| message_id | string | required | Messenger message ID |
| page_id | string | optional | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
POST
messenger_send_message
Send a text Messenger message from a Facebook Page
/{page_id}/messages
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| recipient | object | required | Recipient object containing the user ID |
| message | object | required | Message payload |
| messaging_type | string | optional | Messenger messaging type |
POST
messenger_send_media_message
Send an image, video, audio, or file Messenger message
/{page_id}/messages
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| recipient | object | required | Recipient object containing the user ID |
| message | object | required | Media message payload |
| messaging_type | string | optional | Messenger messaging type |
POST
messenger_mark_message_seen
Mark a Messenger conversation as seen by the Page
/{page_id}/messages
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| recipient | object | required | Recipient object containing the user ID |
| sender_action | string | required | Sender action |
POST
messenger_toggle_typing_indicator
Show or hide the Messenger typing indicator
/{page_id}/messages
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| recipient | object | required | Recipient object containing the user ID |
| sender_action | string | required | Sender action |
GET
messenger_get_page_posts
List posts published by a Facebook Page
/{page_id}/feed
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_page_photos
List photos published by a Facebook Page
/{page_id}/photos
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_page_videos
List videos published by a Facebook Page
/{page_id}/videos
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_page_tagged_posts
List posts where a Facebook Page is tagged
/{page_id}/tagged
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_page_insights
Retrieve analytics and insights for a Facebook Page
/{page_id}/insights
6 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| metric | string | required | Comma-separated insight metrics |
| period | string | optional | Insight period |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_page_roles
List people and tasks or roles for a Facebook Page
/{page_id}/roles
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_scheduled_posts
List scheduled and unpublished Page posts
/{page_id}/scheduled_posts
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
POST
messenger_create_post
Create a text or link post on a Facebook Page
/{page_id}/feed
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| message | string | required | Post text |
| link | string | optional | Optional link |
POST
messenger_create_photo_post
Create a photo post on a Facebook Page
/{page_id}/photos
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| url | string | required | Public image URL |
| caption | string | optional | Photo caption |
POST
messenger_create_video_post
Create a video post on a Facebook Page
/{page_id}/videos
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| file_url | string | required | Public video URL |
| description | string | optional | Video description |
POST
messenger_create_photo_album
Create a photo album on a Facebook Page
/{page_id}/albums
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| name | string | required | Album name |
| message | string | optional | Album description |
POST
messenger_upload_photos_batch
Upload multiple photos to a Facebook Page or album
/{page_id}/photos
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| album_id | string | optional | Optional album ID |
| files | array | required | Photo files or URLs |
GET
messenger_get_post
Get details for a Facebook Page post
/{post_id}
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| post_id | string | required | Facebook post ID |
| page_id | string | optional | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
DELETE
messenger_delete_post
Delete a Facebook Page post
/{post_id}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| post_id | string | required | Facebook post ID |
| page_id | string | optional | Facebook Page ID |
POST
messenger_update_post
Update a Facebook Page post
/{post_id}
4 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| post_id | string | required | Facebook post ID |
| page_id | string | optional | Facebook Page ID |
| message | string | optional | Updated post text |
| scheduled_publish_time | string | optional | Scheduled publish time |
GET
messenger_get_post_insights
Retrieve analytics for a Facebook Page post
/{post_id}/insights
6 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| post_id | string | required | Facebook post ID |
| page_id | string | optional | Facebook Page ID |
| metric | string | optional | Comma-separated insight metrics |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
GET
messenger_get_post_reactions
List reactions on a Facebook Page post
/{post_id}/reactions
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| post_id | string | required | Facebook post ID |
| page_id | string | optional | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
POST
messenger_add_reaction
Add a reaction to a Facebook post or comment
/{object_id}/reactions
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| object_id | string | required | Facebook object ID |
| page_id | string | optional | Facebook Page ID |
| type | string | required | Reaction type |
DELETE
messenger_unlike_post_or_comment
Remove the Page reaction from a post or comment
/{object_id}/likes
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| object_id | string | required | Facebook object ID |
| page_id | string | optional | Facebook Page ID |
GET
messenger_get_comments
List comments on a Facebook post or comment
/{object_id}/comments
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| object_id | string | required | Facebook object ID |
| page_id | string | optional | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
| limit | integer | optional | Maximum number of records to return |
| after | string | optional | Pagination cursor for the next page |
POST
messenger_create_comment
Create a comment or reply on a Facebook post
/{object_id}/comments
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| object_id | string | required | Facebook object ID |
| page_id | string | optional | Facebook Page ID |
| message | string | required | Comment text |
GET
messenger_get_comment
Get details for a Facebook comment
/{comment_id}
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| comment_id | string | required | Facebook comment ID |
| page_id | string | optional | Facebook Page ID |
| fields | string | optional | Comma-separated fields to include |
POST
messenger_update_comment
Update a Facebook comment
/{comment_id}
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| comment_id | string | required | Facebook comment ID |
| page_id | string | optional | Facebook Page ID |
| message | string | required | Updated comment text |
DELETE
messenger_delete_comment
Delete a Facebook comment
/{comment_id}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| comment_id | string | required | Facebook comment ID |
| page_id | string | optional | Facebook Page ID |
POST
messenger_assign_page_task
Assign Page tasks or roles to a business-scoped user
/{page_id}/roles
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| user_id | string | required | Business-scoped user ID |
| tasks | array | required | Page tasks |
DELETE
messenger_remove_page_task
Remove a user's task or access from a Facebook Page
/{page_id}/roles
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| user_id | string | required | Business-scoped user ID |
POST
messenger_update_page_settings
Update settings for a Facebook Page
/{page_id}/settings
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| page_id | string | required | Facebook Page ID |
| settings | object | required | Page settings |
POST
messenger_publish_scheduled_post
Publish a previously scheduled Facebook Page post
/{post_id}
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| post_id | string | required | Facebook post ID |
| page_id | string | optional | Facebook Page ID |
| is_published | boolean | required | Publish the post |
POST
messenger_reschedule_post
Change the scheduled publish time of a Page post
/{post_id}
3 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| post_id | string | required | Facebook post ID |
| page_id | string | optional | Facebook Page ID |
| scheduled_publish_time | string | required | New publish time |