Focus · Facebook Page
Typed Focus mode operations for Facebook Page accounts, generated from the Facebook Page focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_facebook- Posts10
- Scheduled posts6
- Visitor posts3
- Photos5
- Albums4
- Videos11
- Reels8
- Stories3
- Live videos8
- Crossposting4
- Commented posts1
- Comments12
- Mentions2
- Reviews3
- Reactions2
- Blocked users3
- Conversations13
- Handover apps1
- Messenger greeting3
- Messenger get started3
- Messenger ice breakers3
- Messenger menu3
- Messenger domains3
- Personas4
- Labels5
- Message templates3
- Page insights2
- Post insights2
- Video insights2
- Reaction insights1
- Demographics1
- Monetization2
- Page profile4
- Page settings2
- Call to action3
- Webhook subscription3
- Locations1
- Pages2
- Business partners3
- Page roles4
Posts
Facebook Page: List Posts
/accounts/{accountId}/facebook/postsPublished Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call facebook-posts-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
edgestringdefault: "published_posts"published_postsfeed
sincestring (date-time)untilstring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringread-onlymessagestring≤ 63206 characters
created_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlyscheduled_publish_timestring (date-time) | nullpermalink_urlstring (uri)read-onlyfull_picturestring (uri)read-onlystatus_typestringread-onlyis_publishedbooleanread-onlysharesintegerread-onlyreactionsintegerread-onlycommentsintegerread-onlyfromobjectread-onlyShow 2 child attributes
idstringnamestringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Posts item
/accounts/{accountId}/facebook/postsPublish a feed post (text, link, photos, video, carousel). Use options.scheduledPublishTime / draft for native scheduling. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call facebook-posts-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
contentstring≤ 63206 characters
mediaarray of object≤ 10 items
Show 6 item attributes
mediaIdstringSocialit media id
urlstring (uri)typestringimagevideo
altTextstringthumbnailstring (uri)Video cover URL
subtitlesarray of objectShow 2 item attributes
urlstring (uri)languagestringoptionsobjectShow 33 child attributes
contentTypestringdefault: "feed"feed = Page post (text, link, photos, video, carousel); reel = single vertical 3-90 s video; story = 1 photo or video ≤60 s, 24 h, no caption.
feedreelstory
pageIdstringPublish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token.
pattern ^\d+$
linkstring (uri)Link to share (feed text posts). Generates a link preview.
titlestringVideo / Reel title (separate from the caption).
≤ 255 characters
draftbooleandefault: falseCreate an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.
publishedbooleandefault: truefalse = unpublished (same as draft).
scheduledPublishTimestring | integerNative Facebook scheduling: ISO 8601 or unix seconds, 10 minutes to 30 days ahead (Reels ≤29 days). Not for Stories. Socialit-side scheduling does not need this.
geoRestrictionobjectHard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.
Show 1 child attributes
countriesarray of stringrequired1–25 items
targetingobjectRaw Graph targeting object (who can see the post). Overrides geoRestriction.
feedTargetingobjectRaw Graph feed_targeting (News Feed preference, does not restrict visibility): geo_locations {countries|regions|cities}, age_min, age_max, genders, locales, interests… Do not mix countries with regions.
placestringLocation tag: id of a Page with a location.
pattern ^\d+$
carouselCardsarray of objectMulti-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.
2–10 items
Show 4 item attributes
linkstring (uri)requirednamestringHeadline (~35 chars shown).
≤ 255 characters
descriptionstringSubhead (~30 chars shown).
≤ 255 characters
picturestring (uri)Card image URL (defaults to media[i].url).
carouselLinkstring (uri)"See more" end-card URL (defaults to the first card link).
multiShareOptimizedbooleanLet Facebook reorder carousel cards by performance.
multiShareEndCardbooleanShow the Page end card on carousels.
textFormatPresetIdstringText background preset (text-only feed posts; rejected with media, cards, link or empty content).
pattern ^\d+$
callToActionobjectLink-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)
Show 3 child attributes
typestringrequiredLEARN_MORESHOP_NOWBOOK_TRAVELSIGN_UPDOWNLOADWATCH_MORECONTACT_USAPPLY_NOWGET_DIRECTIONSCALL_NOWMESSAGE_PAGEORDER_NOWSUBSCRIBEGET_QUOTENO_BUTTON
linkstring (uri)appLinkstringbackdatedTimestring | integerBackdate a feed/photo post (ISO or unix).
backdatedTimeGranularitystringyearmonthdayhourminnone
noStorybooleanPhotos/videos: upload without generating a feed story.
altTextstringAlt text for photos (alt_text_custom). media[].altText wins per image.
firstCommentstringComment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules).
≤ 8000 characters
thumbnailUrlstring (uri)Custom video / Reel cover (≤10 MB). media[].thumbnail wins.
contentTagsarray of stringVideo content tag ids.
secretbooleanVideo: hide from the Page (unlisted).
embeddablebooleanVideo: allow embedding.
socialActionsbooleanVideo: allow likes/comments/shares.
crosspostToPageIdsarray of stringVideo: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).
crosspostingActionsarray of objectRaw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)
collaboratorsarray of stringReels: Page ids to invite as collaborators (10 invites / Page / 24 h).
uploadModestringdefault: "auto"Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided.
autourlresumable
videoStatestringReels: explicit video_state (derived from draft/schedule by default).
PUBLISHEDSCHEDULEDDRAFT
waitForUploadbooleandefault: trueReels/video Stories: poll upload status before finishing.
Returns object
idstringread-onlymessagestring≤ 63206 characters
created_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlyscheduled_publish_timestring (date-time) | nullpermalink_urlstring (uri)read-onlyfull_picturestring (uri)read-onlystatus_typestringread-onlyis_publishedbooleanread-onlysharesintegerread-onlyreactionsintegerread-onlycommentsintegerread-onlyfromobjectread-onlyShow 2 child attributes
idstringnamestringResponses
Facebook Page: Get a Posts item
/accounts/{accountId}/facebook/posts/{itemId}Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call facebook-posts-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlymessagestring≤ 63206 characters
created_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlyscheduled_publish_timestring (date-time) | nullpermalink_urlstring (uri)read-onlyfull_picturestring (uri)read-onlystatus_typestringread-onlyis_publishedbooleanread-onlysharesintegerread-onlyreactionsintegerread-onlycommentsintegerread-onlyfromobjectread-onlyShow 2 child attributes
idstringnamestringResponses
Facebook Page: Update a Posts item
/accounts/{accountId}/facebook/posts/{itemId}Edit the post text (posts created by Socialit only). Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call facebook-posts-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
messagestring≤ 63206 characters
placestringReturns object
idstringread-onlymessagestring≤ 63206 characters
created_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlyscheduled_publish_timestring (date-time) | nullpermalink_urlstring (uri)read-onlyfull_picturestring (uri)read-onlystatus_typestringread-onlyis_publishedbooleanread-onlysharesintegerread-onlyreactionsintegerread-onlycommentsintegerread-onlyfromobjectread-onlyShow 2 child attributes
idstringnamestringResponses
Facebook Page: Delete a Posts item
/accounts/{accountId}/facebook/posts/{itemId}Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call facebook-posts-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Facebook Page: Like as Page (Posts)
/accounts/{accountId}/facebook/posts/{itemId}/likeLike as Page. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call facebook-posts-like (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Unlike (Posts)
/accounts/{accountId}/facebook/posts/{itemId}/unlikeUnlike. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call facebook-posts-unlike (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Comment as Page (Posts)
/accounts/{accountId}/facebook/posts/{itemId}/commentComment as Page. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call facebook-posts-comment (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≤ 8000 characters
attachmentUrlstring (uri)Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Reaction breakdown (Posts)
/accounts/{accountId}/facebook/posts/{itemId}/reactionsReaction breakdown. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call facebook-posts-reactions (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Post insights (Posts)
/accounts/{accountId}/facebook/posts/{itemId}/insightsPost insights. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, read_insights. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call facebook-posts-insights (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Scheduled posts
Facebook Page: List Scheduled on Facebook
/accounts/{accountId}/facebook/scheduled-postsPosts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/scheduled-posts.
Try it with MCPAsk your agent to call facebook-scheduled-posts-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringread-onlymessagestring≤ 63206 characters
created_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlyscheduled_publish_timestring (date-time) | nullpermalink_urlstring (uri)read-onlyfull_picturestring (uri)read-onlystatus_typestringread-onlyis_publishedbooleanread-onlysharesintegerread-onlyreactionsintegerread-onlycommentsintegerread-onlyfromobjectread-onlyShow 2 child attributes
idstringnamestringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Scheduled on Facebook item
/accounts/{accountId}/facebook/scheduled-postsSchedule a feed post natively (options.scheduledPublishTime required). Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/scheduled-posts.
Try it with MCPAsk your agent to call facebook-scheduled-posts-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
contentstring≤ 63206 characters
mediaarray of object≤ 10 items
Show 6 item attributes
mediaIdstringSocialit media id
urlstring (uri)typestringimagevideo
altTextstringthumbnailstring (uri)Video cover URL
subtitlesarray of objectShow 2 item attributes
urlstring (uri)languagestringoptionsobjectShow 33 child attributes
contentTypestringdefault: "feed"feed = Page post (text, link, photos, video, carousel); reel = single vertical 3-90 s video; story = 1 photo or video ≤60 s, 24 h, no caption.
feedreelstory
pageIdstringPublish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token.
pattern ^\d+$
linkstring (uri)Link to share (feed text posts). Generates a link preview.
titlestringVideo / Reel title (separate from the caption).
≤ 255 characters
draftbooleandefault: falseCreate an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.
publishedbooleandefault: truefalse = unpublished (same as draft).
scheduledPublishTimestring | integerNative Facebook scheduling: ISO 8601 or unix seconds, 10 minutes to 30 days ahead (Reels ≤29 days). Not for Stories. Socialit-side scheduling does not need this.
geoRestrictionobjectHard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.
Show 1 child attributes
countriesarray of stringrequired1–25 items
targetingobjectRaw Graph targeting object (who can see the post). Overrides geoRestriction.
feedTargetingobjectRaw Graph feed_targeting (News Feed preference, does not restrict visibility): geo_locations {countries|regions|cities}, age_min, age_max, genders, locales, interests… Do not mix countries with regions.
placestringLocation tag: id of a Page with a location.
pattern ^\d+$
carouselCardsarray of objectMulti-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.
2–10 items
Show 4 item attributes
linkstring (uri)requirednamestringHeadline (~35 chars shown).
≤ 255 characters
descriptionstringSubhead (~30 chars shown).
≤ 255 characters
picturestring (uri)Card image URL (defaults to media[i].url).
carouselLinkstring (uri)"See more" end-card URL (defaults to the first card link).
multiShareOptimizedbooleanLet Facebook reorder carousel cards by performance.
multiShareEndCardbooleanShow the Page end card on carousels.
textFormatPresetIdstringText background preset (text-only feed posts; rejected with media, cards, link or empty content).
pattern ^\d+$
callToActionobjectLink-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)
Show 3 child attributes
typestringrequiredLEARN_MORESHOP_NOWBOOK_TRAVELSIGN_UPDOWNLOADWATCH_MORECONTACT_USAPPLY_NOWGET_DIRECTIONSCALL_NOWMESSAGE_PAGEORDER_NOWSUBSCRIBEGET_QUOTENO_BUTTON
linkstring (uri)appLinkstringbackdatedTimestring | integerBackdate a feed/photo post (ISO or unix).
backdatedTimeGranularitystringyearmonthdayhourminnone
noStorybooleanPhotos/videos: upload without generating a feed story.
altTextstringAlt text for photos (alt_text_custom). media[].altText wins per image.
firstCommentstringComment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules).
≤ 8000 characters
thumbnailUrlstring (uri)Custom video / Reel cover (≤10 MB). media[].thumbnail wins.
contentTagsarray of stringVideo content tag ids.
secretbooleanVideo: hide from the Page (unlisted).
embeddablebooleanVideo: allow embedding.
socialActionsbooleanVideo: allow likes/comments/shares.
crosspostToPageIdsarray of stringVideo: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).
crosspostingActionsarray of objectRaw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)
collaboratorsarray of stringReels: Page ids to invite as collaborators (10 invites / Page / 24 h).
uploadModestringdefault: "auto"Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided.
autourlresumable
videoStatestringReels: explicit video_state (derived from draft/schedule by default).
PUBLISHEDSCHEDULEDDRAFT
waitForUploadbooleandefault: trueReels/video Stories: poll upload status before finishing.
Returns object
idstringread-onlymessagestring≤ 63206 characters
created_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlyscheduled_publish_timestring (date-time) | nullpermalink_urlstring (uri)read-onlyfull_picturestring (uri)read-onlystatus_typestringread-onlyis_publishedbooleanread-onlysharesintegerread-onlyreactionsintegerread-onlycommentsintegerread-onlyfromobjectread-onlyShow 2 child attributes
idstringnamestringResponses
Facebook Page: Update a Scheduled on Facebook item
/accounts/{accountId}/facebook/scheduled-posts/{itemId}Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/scheduled-posts.
Try it with MCPAsk your agent to call facebook-scheduled-posts-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
messagestringscheduled_publish_timestring (date-time)Returns object
idstringread-onlymessagestring≤ 63206 characters
created_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlyscheduled_publish_timestring (date-time) | nullpermalink_urlstring (uri)read-onlyfull_picturestring (uri)read-onlystatus_typestringread-onlyis_publishedbooleanread-onlysharesintegerread-onlyreactionsintegerread-onlycommentsintegerread-onlyfromobjectread-onlyShow 2 child attributes
idstringnamestringResponses
Facebook Page: Delete a Scheduled on Facebook item
/accounts/{accountId}/facebook/scheduled-posts/{itemId}Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/scheduled-posts.
Try it with MCPAsk your agent to call facebook-scheduled-posts-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Facebook Page: Publish now (Scheduled on Facebook)
/accounts/{accountId}/facebook/scheduled-posts/{itemId}/publish-nowPublish now. Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/scheduled-posts.
Try it with MCPAsk your agent to call facebook-scheduled-posts-publish-now (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Reschedule (Scheduled on Facebook)
/accounts/{accountId}/facebook/scheduled-posts/{itemId}/rescheduleReschedule. Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: /v1/accounts/{accountId}/focus/scheduled-posts.
Try it with MCPAsk your agent to call facebook-scheduled-posts-reschedule (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
scheduled_publish_timestring (date-time)requiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Visitor posts
Facebook Page: List Visitor posts
/accounts/{accountId}/facebook/visitor-postsPosts by people on the Page. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_user_content. Generic route: /v1/accounts/{accountId}/focus/visitor-posts.
Try it with MCPAsk your agent to call facebook-visitor-posts-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlytextstringread-onlyauthorstringread-onlyauthor_idstringread-onlycreated_atstring (date-time)read-onlyurlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Delete a Visitor posts item
/accounts/{accountId}/facebook/visitor-posts/{itemId}Posts by people on the Page. Requires scopes: pages_read_user_content, pages_manage_engagement. Generic route: /v1/accounts/{accountId}/focus/visitor-posts.
Try it with MCPAsk your agent to call facebook-visitor-posts-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Facebook Page: Reply (Visitor posts)
/accounts/{accountId}/facebook/visitor-posts/{itemId}/replyReply. Posts by people on the Page. Requires scopes: pages_read_user_content, pages_manage_engagement. Generic route: /v1/accounts/{accountId}/focus/visitor-posts.
Try it with MCPAsk your agent to call facebook-visitor-posts-reply (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≤ 8000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Photos
Facebook Page: List Photos
/accounts/{accountId}/facebook/photosCursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/photos/ Generic route: /v1/accounts/{accountId}/focus/photos.
Try it with MCPAsk your agent to call facebook-photos-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
typestringdefault: "uploaded"uploadedtagged
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringread-onlycaptionstringread-onlyalt_textstringalt_text_custom
created_timestring (date-time)read-onlylinkstring (uri)read-onlypicturestring (uri)read-onlyimage_urlstring (uri)read-onlywidthintegerread-onlyheightintegerread-onlyalbumobject | nullread-onlyShow 2 child attributes
idstringnamestringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Photos item
/accounts/{accountId}/facebook/photosPublish a photo (or 2-10 photos as one post). Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/photos/ Generic route: /v1/accounts/{accountId}/focus/photos.
Try it with MCPAsk your agent to call facebook-photos-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
contentstring≤ 63206 characters
mediaarray of object≤ 10 items
Show 6 item attributes
mediaIdstringSocialit media id
urlstring (uri)typestringimagevideo
altTextstringthumbnailstring (uri)Video cover URL
subtitlesarray of objectShow 2 item attributes
urlstring (uri)languagestringoptionsobjectShow 33 child attributes
contentTypestringdefault: "feed"feed = Page post (text, link, photos, video, carousel); reel = single vertical 3-90 s video; story = 1 photo or video ≤60 s, 24 h, no caption.
feedreelstory
pageIdstringPublish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token.
pattern ^\d+$
linkstring (uri)Link to share (feed text posts). Generates a link preview.
titlestringVideo / Reel title (separate from the caption).
≤ 255 characters
draftbooleandefault: falseCreate an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.
publishedbooleandefault: truefalse = unpublished (same as draft).
scheduledPublishTimestring | integerNative Facebook scheduling: ISO 8601 or unix seconds, 10 minutes to 30 days ahead (Reels ≤29 days). Not for Stories. Socialit-side scheduling does not need this.
geoRestrictionobjectHard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.
Show 1 child attributes
countriesarray of stringrequired1–25 items
targetingobjectRaw Graph targeting object (who can see the post). Overrides geoRestriction.
feedTargetingobjectRaw Graph feed_targeting (News Feed preference, does not restrict visibility): geo_locations {countries|regions|cities}, age_min, age_max, genders, locales, interests… Do not mix countries with regions.
placestringLocation tag: id of a Page with a location.
pattern ^\d+$
carouselCardsarray of objectMulti-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.
2–10 items
Show 4 item attributes
linkstring (uri)requirednamestringHeadline (~35 chars shown).
≤ 255 characters
descriptionstringSubhead (~30 chars shown).
≤ 255 characters
picturestring (uri)Card image URL (defaults to media[i].url).
carouselLinkstring (uri)"See more" end-card URL (defaults to the first card link).
multiShareOptimizedbooleanLet Facebook reorder carousel cards by performance.
multiShareEndCardbooleanShow the Page end card on carousels.
textFormatPresetIdstringText background preset (text-only feed posts; rejected with media, cards, link or empty content).
pattern ^\d+$
callToActionobjectLink-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)
Show 3 child attributes
typestringrequiredLEARN_MORESHOP_NOWBOOK_TRAVELSIGN_UPDOWNLOADWATCH_MORECONTACT_USAPPLY_NOWGET_DIRECTIONSCALL_NOWMESSAGE_PAGEORDER_NOWSUBSCRIBEGET_QUOTENO_BUTTON
linkstring (uri)appLinkstringbackdatedTimestring | integerBackdate a feed/photo post (ISO or unix).
backdatedTimeGranularitystringyearmonthdayhourminnone
noStorybooleanPhotos/videos: upload without generating a feed story.
altTextstringAlt text for photos (alt_text_custom). media[].altText wins per image.
firstCommentstringComment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules).
≤ 8000 characters
thumbnailUrlstring (uri)Custom video / Reel cover (≤10 MB). media[].thumbnail wins.
contentTagsarray of stringVideo content tag ids.
secretbooleanVideo: hide from the Page (unlisted).
embeddablebooleanVideo: allow embedding.
socialActionsbooleanVideo: allow likes/comments/shares.
crosspostToPageIdsarray of stringVideo: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).
crosspostingActionsarray of objectRaw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)
collaboratorsarray of stringReels: Page ids to invite as collaborators (10 invites / Page / 24 h).
uploadModestringdefault: "auto"Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided.
autourlresumable
videoStatestringReels: explicit video_state (derived from draft/schedule by default).
PUBLISHEDSCHEDULEDDRAFT
waitForUploadbooleandefault: trueReels/video Stories: poll upload status before finishing.
Returns object
idstringread-onlycaptionstringread-onlyalt_textstringalt_text_custom
created_timestring (date-time)read-onlylinkstring (uri)read-onlypicturestring (uri)read-onlyimage_urlstring (uri)read-onlywidthintegerread-onlyheightintegerread-onlyalbumobject | nullread-onlyShow 2 child attributes
idstringnamestringResponses
Facebook Page: Get a Photos item
/accounts/{accountId}/facebook/photos/{itemId}Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/photos/ Generic route: /v1/accounts/{accountId}/focus/photos.
Try it with MCPAsk your agent to call facebook-photos-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlycaptionstringread-onlyalt_textstringalt_text_custom
created_timestring (date-time)read-onlylinkstring (uri)read-onlypicturestring (uri)read-onlyimage_urlstring (uri)read-onlywidthintegerread-onlyheightintegerread-onlyalbumobject | nullread-onlyShow 2 child attributes
idstringnamestringResponses
Facebook Page: Update a Photos item
/accounts/{accountId}/facebook/photos/{itemId}Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/photos/ Generic route: /v1/accounts/{accountId}/focus/photos.
Try it with MCPAsk your agent to call facebook-photos-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
alt_textstringrequiredReturns object
idstringread-onlycaptionstringread-onlyalt_textstringalt_text_custom
created_timestring (date-time)read-onlylinkstring (uri)read-onlypicturestring (uri)read-onlyimage_urlstring (uri)read-onlywidthintegerread-onlyheightintegerread-onlyalbumobject | nullread-onlyShow 2 child attributes
idstringnamestringResponses
Facebook Page: Delete a Photos item
/accounts/{accountId}/facebook/photos/{itemId}Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/photos/ Generic route: /v1/accounts/{accountId}/focus/photos.
Try it with MCPAsk your agent to call facebook-photos-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Albums
Facebook Page: List Albums
/accounts/{accountId}/facebook/albumsCursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/albums/ Generic route: /v1/accounts/{accountId}/focus/albums.
Try it with MCPAsk your agent to call facebook-albums-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringread-onlynamestringdescriptionstringcountintegerread-onlycreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylinkstring (uri)read-onlytypestringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Albums item
/accounts/{accountId}/facebook/albumsRequires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/albums/ Generic route: /v1/accounts/{accountId}/focus/albums.
Try it with MCPAsk your agent to call facebook-albums-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequireddescriptionstringplacestringReturns object
idstringread-onlynamestringdescriptionstringcountintegerread-onlycreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylinkstring (uri)read-onlytypestringread-onlyResponses
Facebook Page: List photos (Albums)
/accounts/{accountId}/facebook/albums/{itemId}/photosList photos. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/albums/ Generic route: /v1/accounts/{accountId}/focus/albums.
Try it with MCPAsk your agent to call facebook-albums-photos (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Add photo (Albums)
/accounts/{accountId}/facebook/albums/{itemId}/add-photoAdd photo. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/albums/ Generic route: /v1/accounts/{accountId}/focus/albums.
Try it with MCPAsk your agent to call facebook-albums-add-photo (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
urlstring (uri)mediaIdstringcaptionstringaltTextstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Videos
Facebook Page: List Videos
/accounts/{accountId}/facebook/videosFeed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
typestringdefault: "uploaded"uploadedtagged
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringread-onlytitlestring≤ 255 characters
descriptionstringcreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylengthnumberread-onlyseconds
permalink_urlstring (uri)read-onlypicturestring (uri)read-onlypublishedbooleanread-onlystatusstringread-onlyembeddablebooleanpost_idstring | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Videos item
/accounts/{accountId}/facebook/videosFeed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
contentstring≤ 63206 characters
mediaarray of object≤ 10 items
Show 6 item attributes
mediaIdstringSocialit media id
urlstring (uri)typestringimagevideo
altTextstringthumbnailstring (uri)Video cover URL
subtitlesarray of objectShow 2 item attributes
urlstring (uri)languagestringoptionsobjectShow 33 child attributes
contentTypestringdefault: "feed"feed = Page post (text, link, photos, video, carousel); reel = single vertical 3-90 s video; story = 1 photo or video ≤60 s, 24 h, no caption.
feedreelstory
pageIdstringPublish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token.
pattern ^\d+$
linkstring (uri)Link to share (feed text posts). Generates a link preview.
titlestringVideo / Reel title (separate from the caption).
≤ 255 characters
draftbooleandefault: falseCreate an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.
publishedbooleandefault: truefalse = unpublished (same as draft).
scheduledPublishTimestring | integerNative Facebook scheduling: ISO 8601 or unix seconds, 10 minutes to 30 days ahead (Reels ≤29 days). Not for Stories. Socialit-side scheduling does not need this.
geoRestrictionobjectHard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.
Show 1 child attributes
countriesarray of stringrequired1–25 items
targetingobjectRaw Graph targeting object (who can see the post). Overrides geoRestriction.
feedTargetingobjectRaw Graph feed_targeting (News Feed preference, does not restrict visibility): geo_locations {countries|regions|cities}, age_min, age_max, genders, locales, interests… Do not mix countries with regions.
placestringLocation tag: id of a Page with a location.
pattern ^\d+$
carouselCardsarray of objectMulti-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.
2–10 items
Show 4 item attributes
linkstring (uri)requirednamestringHeadline (~35 chars shown).
≤ 255 characters
descriptionstringSubhead (~30 chars shown).
≤ 255 characters
picturestring (uri)Card image URL (defaults to media[i].url).
carouselLinkstring (uri)"See more" end-card URL (defaults to the first card link).
multiShareOptimizedbooleanLet Facebook reorder carousel cards by performance.
multiShareEndCardbooleanShow the Page end card on carousels.
textFormatPresetIdstringText background preset (text-only feed posts; rejected with media, cards, link or empty content).
pattern ^\d+$
callToActionobjectLink-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)
Show 3 child attributes
typestringrequiredLEARN_MORESHOP_NOWBOOK_TRAVELSIGN_UPDOWNLOADWATCH_MORECONTACT_USAPPLY_NOWGET_DIRECTIONSCALL_NOWMESSAGE_PAGEORDER_NOWSUBSCRIBEGET_QUOTENO_BUTTON
linkstring (uri)appLinkstringbackdatedTimestring | integerBackdate a feed/photo post (ISO or unix).
backdatedTimeGranularitystringyearmonthdayhourminnone
noStorybooleanPhotos/videos: upload without generating a feed story.
altTextstringAlt text for photos (alt_text_custom). media[].altText wins per image.
firstCommentstringComment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules).
≤ 8000 characters
thumbnailUrlstring (uri)Custom video / Reel cover (≤10 MB). media[].thumbnail wins.
contentTagsarray of stringVideo content tag ids.
secretbooleanVideo: hide from the Page (unlisted).
embeddablebooleanVideo: allow embedding.
socialActionsbooleanVideo: allow likes/comments/shares.
crosspostToPageIdsarray of stringVideo: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).
crosspostingActionsarray of objectRaw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)
collaboratorsarray of stringReels: Page ids to invite as collaborators (10 invites / Page / 24 h).
uploadModestringdefault: "auto"Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided.
autourlresumable
videoStatestringReels: explicit video_state (derived from draft/schedule by default).
PUBLISHEDSCHEDULEDDRAFT
waitForUploadbooleandefault: trueReels/video Stories: poll upload status before finishing.
Returns object
idstringread-onlytitlestring≤ 255 characters
descriptionstringcreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylengthnumberread-onlyseconds
permalink_urlstring (uri)read-onlypicturestring (uri)read-onlypublishedbooleanread-onlystatusstringread-onlyembeddablebooleanpost_idstring | nullread-onlyResponses
Facebook Page: Get a Videos item
/accounts/{accountId}/facebook/videos/{itemId}Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestring≤ 255 characters
descriptionstringcreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylengthnumberread-onlyseconds
permalink_urlstring (uri)read-onlypicturestring (uri)read-onlypublishedbooleanread-onlystatusstringread-onlyembeddablebooleanpost_idstring | nullread-onlyResponses
Facebook Page: Update a Videos item
/accounts/{accountId}/facebook/videos/{itemId}Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestring≤ 255 characters
descriptionstringReturns object
idstringread-onlytitlestring≤ 255 characters
descriptionstringcreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylengthnumberread-onlyseconds
permalink_urlstring (uri)read-onlypicturestring (uri)read-onlypublishedbooleanread-onlystatusstringread-onlyembeddablebooleanpost_idstring | nullread-onlyResponses
Facebook Page: Delete a Videos item
/accounts/{accountId}/facebook/videos/{itemId}Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Facebook Page: Video insights (Videos)
/accounts/{accountId}/facebook/videos/{itemId}/insightsVideo insights. Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, read_insights. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-insights (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Thumbnails (Videos)
/accounts/{accountId}/facebook/videos/{itemId}/thumbnailsThumbnails. Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-thumbnails (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Upload thumbnail (Videos)
/accounts/{accountId}/facebook/videos/{itemId}/set-thumbnailUpload thumbnail. Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-set-thumbnail (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
urlstring (uri)mediaIdstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Captions (Videos)
/accounts/{accountId}/facebook/videos/{itemId}/captionsCaptions. Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-captions (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Upload captions (.srt) (Videos)
/accounts/{accountId}/facebook/videos/{itemId}/add-captionsUpload captions (.srt). Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-add-captions (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
urlstring (uri)requiredlanguagestringdefault: "en_US"isDefaultbooleanReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Delete captions (Videos)
/accounts/{accountId}/facebook/videos/{itemId}/delete-captionsDelete captions. Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Destructive. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call facebook-videos-delete-captions (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
localestringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reels
Facebook Page: List Reels
/accounts/{accountId}/facebook/reelsVertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: /v1/accounts/{accountId}/focus/reels.
Try it with MCPAsk your agent to call facebook-reels-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
sincestring (date-time)untilstring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringread-onlytitlestring≤ 255 characters
descriptionstringcreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylengthnumberread-onlyseconds
permalink_urlstring (uri)read-onlypicturestring (uri)read-onlypublishedbooleanread-onlystatusstringread-onlyembeddablebooleanpost_idstring | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Reels item
/accounts/{accountId}/facebook/reelsVertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: /v1/accounts/{accountId}/focus/reels.
Try it with MCPAsk your agent to call facebook-reels-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
contentstring≤ 63206 characters
mediaarray of object≤ 10 items
Show 6 item attributes
mediaIdstringSocialit media id
urlstring (uri)typestringimagevideo
altTextstringthumbnailstring (uri)Video cover URL
subtitlesarray of objectShow 2 item attributes
urlstring (uri)languagestringoptionsobjectShow 33 child attributes
contentTypestringdefault: "feed"feed = Page post (text, link, photos, video, carousel); reel = single vertical 3-90 s video; story = 1 photo or video ≤60 s, 24 h, no caption.
feedreelstory
pageIdstringPublish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token.
pattern ^\d+$
linkstring (uri)Link to share (feed text posts). Generates a link preview.
titlestringVideo / Reel title (separate from the caption).
≤ 255 characters
draftbooleandefault: falseCreate an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.
publishedbooleandefault: truefalse = unpublished (same as draft).
scheduledPublishTimestring | integerNative Facebook scheduling: ISO 8601 or unix seconds, 10 minutes to 30 days ahead (Reels ≤29 days). Not for Stories. Socialit-side scheduling does not need this.
geoRestrictionobjectHard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.
Show 1 child attributes
countriesarray of stringrequired1–25 items
targetingobjectRaw Graph targeting object (who can see the post). Overrides geoRestriction.
feedTargetingobjectRaw Graph feed_targeting (News Feed preference, does not restrict visibility): geo_locations {countries|regions|cities}, age_min, age_max, genders, locales, interests… Do not mix countries with regions.
placestringLocation tag: id of a Page with a location.
pattern ^\d+$
carouselCardsarray of objectMulti-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.
2–10 items
Show 4 item attributes
linkstring (uri)requirednamestringHeadline (~35 chars shown).
≤ 255 characters
descriptionstringSubhead (~30 chars shown).
≤ 255 characters
picturestring (uri)Card image URL (defaults to media[i].url).
carouselLinkstring (uri)"See more" end-card URL (defaults to the first card link).
multiShareOptimizedbooleanLet Facebook reorder carousel cards by performance.
multiShareEndCardbooleanShow the Page end card on carousels.
textFormatPresetIdstringText background preset (text-only feed posts; rejected with media, cards, link or empty content).
pattern ^\d+$
callToActionobjectLink-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)
Show 3 child attributes
typestringrequiredLEARN_MORESHOP_NOWBOOK_TRAVELSIGN_UPDOWNLOADWATCH_MORECONTACT_USAPPLY_NOWGET_DIRECTIONSCALL_NOWMESSAGE_PAGEORDER_NOWSUBSCRIBEGET_QUOTENO_BUTTON
linkstring (uri)appLinkstringbackdatedTimestring | integerBackdate a feed/photo post (ISO or unix).
backdatedTimeGranularitystringyearmonthdayhourminnone
noStorybooleanPhotos/videos: upload without generating a feed story.
altTextstringAlt text for photos (alt_text_custom). media[].altText wins per image.
firstCommentstringComment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules).
≤ 8000 characters
thumbnailUrlstring (uri)Custom video / Reel cover (≤10 MB). media[].thumbnail wins.
contentTagsarray of stringVideo content tag ids.
secretbooleanVideo: hide from the Page (unlisted).
embeddablebooleanVideo: allow embedding.
socialActionsbooleanVideo: allow likes/comments/shares.
crosspostToPageIdsarray of stringVideo: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).
crosspostingActionsarray of objectRaw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)
collaboratorsarray of stringReels: Page ids to invite as collaborators (10 invites / Page / 24 h).
uploadModestringdefault: "auto"Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided.
autourlresumable
videoStatestringReels: explicit video_state (derived from draft/schedule by default).
PUBLISHEDSCHEDULEDDRAFT
waitForUploadbooleandefault: trueReels/video Stories: poll upload status before finishing.
Returns object
idstringread-onlytitlestring≤ 255 characters
descriptionstringcreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylengthnumberread-onlyseconds
permalink_urlstring (uri)read-onlypicturestring (uri)read-onlypublishedbooleanread-onlystatusstringread-onlyembeddablebooleanpost_idstring | nullread-onlyResponses
Facebook Page: Get a Reels item
/accounts/{accountId}/facebook/reels/{itemId}Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: /v1/accounts/{accountId}/focus/reels.
Try it with MCPAsk your agent to call facebook-reels-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestring≤ 255 characters
descriptionstringcreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylengthnumberread-onlyseconds
permalink_urlstring (uri)read-onlypicturestring (uri)read-onlypublishedbooleanread-onlystatusstringread-onlyembeddablebooleanpost_idstring | nullread-onlyResponses
Facebook Page: Update a Reels item
/accounts/{accountId}/facebook/reels/{itemId}Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: /v1/accounts/{accountId}/focus/reels.
Try it with MCPAsk your agent to call facebook-reels-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestringdescriptionstringReturns object
idstringread-onlytitlestring≤ 255 characters
descriptionstringcreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylengthnumberread-onlyseconds
permalink_urlstring (uri)read-onlypicturestring (uri)read-onlypublishedbooleanread-onlystatusstringread-onlyembeddablebooleanpost_idstring | nullread-onlyResponses
Facebook Page: Delete a Reels item
/accounts/{accountId}/facebook/reels/{itemId}Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: /v1/accounts/{accountId}/focus/reels.
Try it with MCPAsk your agent to call facebook-reels-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Facebook Page: Reel insights (Reels)
/accounts/{accountId}/facebook/reels/{itemId}/insightsReel insights. Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement, read_insights. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: /v1/accounts/{accountId}/focus/reels.
Try it with MCPAsk your agent to call facebook-reels-insights (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Collaborators (Reels)
/accounts/{accountId}/facebook/reels/{itemId}/collaboratorsCollaborators. Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: /v1/accounts/{accountId}/focus/reels.
Try it with MCPAsk your agent to call facebook-reels-collaborators (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Invite collaborator (Reels)
/accounts/{accountId}/facebook/reels/{itemId}/invite-collaboratorInvite collaborator. Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: /v1/accounts/{accountId}/focus/reels.
Try it with MCPAsk your agent to call facebook-reels-invite-collaborator (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
pageIdstringrequiredpattern ^\d+$
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Stories
Facebook Page: List Stories
/accounts/{accountId}/facebook/storiesPage Stories (24 h). One photo or a ≤60 s video; no stickers, links or scheduling via API. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/page-stories-api Generic route: /v1/accounts/{accountId}/focus/stories.
Try it with MCPAsk your agent to call facebook-stories-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
sincestring (date-time)untilstring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlystatusstringread-onlyPUBLISHEDARCHIVED
media_typestringread-onlymedia_idstringread-onlyurlstring (uri)read-onlycreated_timestring (date-time)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Stories item
/accounts/{accountId}/facebook/storiesPage Stories (24 h). One photo or a ≤60 s video; no stickers, links or scheduling via API. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/page-stories-api Generic route: /v1/accounts/{accountId}/focus/stories.
Try it with MCPAsk your agent to call facebook-stories-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediaarray of objectrequiredexactly 1 items
Show 6 item attributes
mediaIdstringSocialit media id
urlstring (uri)typestringimagevideo
altTextstringthumbnailstring (uri)Video cover URL
subtitlesarray of objectShow 2 item attributes
urlstring (uri)languagestringReturns object
idstringread-onlystatusstringread-onlyPUBLISHEDARCHIVED
media_typestringread-onlymedia_idstringread-onlyurlstring (uri)read-onlycreated_timestring (date-time)read-onlyResponses
Facebook Page: Story insights (Stories)
/accounts/{accountId}/facebook/stories/{itemId}/insightsStory insights. Page Stories (24 h). One photo or a ≤60 s video; no stickers, links or scheduling via API. Requires scopes: pages_read_engagement, read_insights. Network docs: https://developers.facebook.com/docs/page-stories-api Generic route: /v1/accounts/{accountId}/focus/stories.
Try it with MCPAsk your agent to call facebook-stories-insights (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Live videos
Facebook Page: List Live
/accounts/{accountId}/facebook/live-videosLive broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Cursor pagination: pass next_cursor back as cursor. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: /v1/accounts/{accountId}/focus/live-videos.
Try it with MCPAsk your agent to call facebook-live-videos-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
broadcastStatusstringLIVEUNPUBLISHEDSCHEDULED_UNPUBLISHEDVODPROCESSING
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringread-onlytitlestringdescriptionstringstatusstringLIVE_NOWSCHEDULED_UNPUBLISHEDUNPUBLISHEDLIVEVODSCHEDULED_LIVESCHEDULED_CANCELEDPROCESSING
planned_start_timestring (date-time) | nullcreated_timestring (date-time)read-onlypermalink_urlstring (uri)read-onlysecure_stream_urlstringread-onlyRTMPS URL (server + key)
stream_serverstringread-onlystream_keystring (password)read-onlylive_viewsintegerread-onlyvideo_idstring | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Live item
/accounts/{accountId}/facebook/live-videosLive broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: /v1/accounts/{accountId}/focus/live-videos.
Try it with MCPAsk your agent to call facebook-live-videos-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringdescriptionstringstatusstringdefault: "UNPUBLISHED"LIVE_NOWSCHEDULED_UNPUBLISHEDUNPUBLISHED
plannedStartTimestring (date-time)enableBackupIngestbooleanReturns object
idstringread-onlytitlestringdescriptionstringstatusstringLIVE_NOWSCHEDULED_UNPUBLISHEDUNPUBLISHEDLIVEVODSCHEDULED_LIVESCHEDULED_CANCELEDPROCESSING
planned_start_timestring (date-time) | nullcreated_timestring (date-time)read-onlypermalink_urlstring (uri)read-onlysecure_stream_urlstringread-onlyRTMPS URL (server + key)
stream_serverstringread-onlystream_keystring (password)read-onlylive_viewsintegerread-onlyvideo_idstring | nullread-onlyResponses
Facebook Page: Get a Live item
/accounts/{accountId}/facebook/live-videos/{itemId}Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: /v1/accounts/{accountId}/focus/live-videos.
Try it with MCPAsk your agent to call facebook-live-videos-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestringdescriptionstringstatusstringLIVE_NOWSCHEDULED_UNPUBLISHEDUNPUBLISHEDLIVEVODSCHEDULED_LIVESCHEDULED_CANCELEDPROCESSING
planned_start_timestring (date-time) | nullcreated_timestring (date-time)read-onlypermalink_urlstring (uri)read-onlysecure_stream_urlstringread-onlyRTMPS URL (server + key)
stream_serverstringread-onlystream_keystring (password)read-onlylive_viewsintegerread-onlyvideo_idstring | nullread-onlyResponses
Facebook Page: Update a Live item
/accounts/{accountId}/facebook/live-videos/{itemId}Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: /v1/accounts/{accountId}/focus/live-videos.
Try it with MCPAsk your agent to call facebook-live-videos-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestringdescriptionstringplannedStartTimestring (date-time)Returns object
idstringread-onlytitlestringdescriptionstringstatusstringLIVE_NOWSCHEDULED_UNPUBLISHEDUNPUBLISHEDLIVEVODSCHEDULED_LIVESCHEDULED_CANCELEDPROCESSING
planned_start_timestring (date-time) | nullcreated_timestring (date-time)read-onlypermalink_urlstring (uri)read-onlysecure_stream_urlstringread-onlyRTMPS URL (server + key)
stream_serverstringread-onlystream_keystring (password)read-onlylive_viewsintegerread-onlyvideo_idstring | nullread-onlyResponses
Facebook Page: Delete a Live item
/accounts/{accountId}/facebook/live-videos/{itemId}Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: /v1/accounts/{accountId}/focus/live-videos.
Try it with MCPAsk your agent to call facebook-live-videos-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Facebook Page: Go live (Live)
/accounts/{accountId}/facebook/live-videos/{itemId}/go-liveGo live. Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: /v1/accounts/{accountId}/focus/live-videos.
Try it with MCPAsk your agent to call facebook-live-videos-go-live (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: End broadcast (Live)
/accounts/{accountId}/facebook/live-videos/{itemId}/endEnd broadcast. Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Destructive. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: /v1/accounts/{accountId}/focus/live-videos.
Try it with MCPAsk your agent to call facebook-live-videos-end (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Live comments (Live)
/accounts/{accountId}/facebook/live-videos/{itemId}/commentsLive comments. Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts, pages_read_user_content. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: /v1/accounts/{accountId}/focus/live-videos.
Try it with MCPAsk your agent to call facebook-live-videos-comments (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Crossposting
Facebook Page: List Crossposting
/accounts/{accountId}/facebook/crosspostingVideo crossposting relationships with partner Pages; crosspost a partner video. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/crossposting Generic route: /v1/accounts/{accountId}/focus/crossposting.
Try it with MCPAsk your agent to call facebook-crossposting-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringread-onlynamestringread-onlyallows_live_crosspostsboolean | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Crossposting item
/accounts/{accountId}/facebook/crosspostingRequest a crossposting relationship (handshake) with partner Pages. Video crossposting relationships with partner Pages; crosspost a partner video. Requires scopes: pages_manage_posts, pages_manage_metadata. Network docs: https://developers.facebook.com/docs/video-api/guides/crossposting Generic route: /v1/accounts/{accountId}/focus/crossposting.
Try it with MCPAsk your agent to call facebook-crossposting-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
partnerPageIdsarray of stringrequired≥ 1 items
allowLivebooleandefault: trueReturns object
idstringread-onlynamestringread-onlyallows_live_crosspostsboolean | nullread-onlyResponses
Facebook Page: Accept handshake (Crossposting)
/accounts/{accountId}/facebook/crossposting/acceptAccept handshake. Video crossposting relationships with partner Pages; crosspost a partner video. Requires scopes: pages_manage_posts, pages_manage_metadata. Network docs: https://developers.facebook.com/docs/video-api/guides/crossposting Generic route: /v1/accounts/{accountId}/focus/crossposting.
Try it with MCPAsk your agent to call facebook-crossposting-accept (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
partnerPageIdstringrequiredallowLivebooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Crosspost a video (Crossposting)
/accounts/{accountId}/facebook/crossposting/crosspost-videoCrosspost a video. Video crossposting relationships with partner Pages; crosspost a partner video. Requires scopes: pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/crossposting Generic route: /v1/accounts/{accountId}/focus/crossposting.
Try it with MCPAsk your agent to call facebook-crossposting-crosspost-video (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
videoIdstringrequireddescriptionstringscheduledPublishTimestring (date-time)Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Commented posts
Facebook Page: List Posts with comments
/accounts/{accountId}/facebook/commented-postsRecent Page posts with comment counts — pick one to moderate its comments. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement. Generic route: /v1/accounts/{accountId}/focus/commented-posts.
Try it with MCPAsk your agent to call facebook-commented-posts-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
sincestring (date-time)minCommentsintegerReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlymessagestringread-onlycreated_timestring (date-time)read-onlypermalink_urlstring (uri)read-onlyfull_picturestring (uri)read-onlycomment_countintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Comments
Facebook Page: List Comments
/accounts/{accountId}/facebook/commentsComments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement, pages_read_user_content. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
object_idstringrequiredPost / photo / video / comment id
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
filterstringdefault: "toplevel"toplevelstream
orderstringdefault: "reverse_chronological"chronologicalreverse_chronological
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 17 item attributes
idstringread-onlytextstring≤ 8000 characters
authorstringread-onlyauthor_idstringread-onlycreated_atstring (date-time)read-onlylike_countintegerread-onlyreply_countintegerread-onlyparent_idstring | nullread-onlypost_idstring | nullread-onlyis_hiddenbooleanread-onlycan_hideboolean | nullread-onlycan_removeboolean | nullread-onlycan_reply_privatelyboolean | nullread-onlyliked_by_pagebooleanread-onlyfrom_pagebooleanread-onlyattachmentobject | nullread-onlypermalink_urlstring (uri) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Comments item
/accounts/{accountId}/facebook/commentsComment on an object (top-level) or reply to a comment (object_id = comment id). Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
object_idstringrequiredmessagestring≤ 8000 characters
attachmentUrlstring (uri)Photo / GIF comment
attachmentShareUrlstring (uri)Returns object
idstringread-onlytextstring≤ 8000 characters
authorstringread-onlyauthor_idstringread-onlycreated_atstring (date-time)read-onlylike_countintegerread-onlyreply_countintegerread-onlyparent_idstring | nullread-onlypost_idstring | nullread-onlyis_hiddenbooleanread-onlycan_hideboolean | nullread-onlycan_removeboolean | nullread-onlycan_reply_privatelyboolean | nullread-onlyliked_by_pagebooleanread-onlyfrom_pagebooleanread-onlyattachmentobject | nullread-onlypermalink_urlstring (uri) | nullread-onlyResponses
Facebook Page: Get a Comments item
/accounts/{accountId}/facebook/comments/{itemId}Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytextstring≤ 8000 characters
authorstringread-onlyauthor_idstringread-onlycreated_atstring (date-time)read-onlylike_countintegerread-onlyreply_countintegerread-onlyparent_idstring | nullread-onlypost_idstring | nullread-onlyis_hiddenbooleanread-onlycan_hideboolean | nullread-onlycan_removeboolean | nullread-onlycan_reply_privatelyboolean | nullread-onlyliked_by_pagebooleanread-onlyfrom_pagebooleanread-onlyattachmentobject | nullread-onlypermalink_urlstring (uri) | nullread-onlyResponses
Facebook Page: Update a Comments item
/accounts/{accountId}/facebook/comments/{itemId}Edit a comment the Page wrote. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
textstringrequired≤ 8000 characters
Returns object
idstringread-onlytextstring≤ 8000 characters
authorstringread-onlyauthor_idstringread-onlycreated_atstring (date-time)read-onlylike_countintegerread-onlyreply_countintegerread-onlyparent_idstring | nullread-onlypost_idstring | nullread-onlyis_hiddenbooleanread-onlycan_hideboolean | nullread-onlycan_removeboolean | nullread-onlycan_reply_privatelyboolean | nullread-onlyliked_by_pagebooleanread-onlyfrom_pagebooleanread-onlyattachmentobject | nullread-onlypermalink_urlstring (uri) | nullread-onlyResponses
Facebook Page: Delete a Comments item
/accounts/{accountId}/facebook/comments/{itemId}Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Facebook Page: Reply (Comments)
/accounts/{accountId}/facebook/comments/{itemId}/replyReply. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-reply (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≤ 8000 characters
attachmentUrlstring (uri)Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Hide (Comments)
/accounts/{accountId}/facebook/comments/{itemId}/hideHide. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-hide (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Unhide (Comments)
/accounts/{accountId}/facebook/comments/{itemId}/unhideUnhide. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-unhide (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Like (Comments)
/accounts/{accountId}/facebook/comments/{itemId}/likeLike. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-like (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Unlike (Comments)
/accounts/{accountId}/facebook/comments/{itemId}/unlikeUnlike. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-unlike (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Replies (Comments)
/accounts/{accountId}/facebook/comments/{itemId}/repliesReplies. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-replies (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Reply privately (Messenger) (Comments)
/accounts/{accountId}/facebook/comments/{itemId}/private-replyOne message within 7 days of the comment. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_messaging. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call facebook-comments-private-reply (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≤ 2000 characters
quickRepliesarray of object≤ 13 items
Show 2 item attributes
titlestringpayloadstringbuttonsarray of object≤ 3 items
Show 5 item attributes
typestringurlpostbackphone
titlestringurlstring (uri)payloadstringphonestringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mentions
Facebook Page: List Mentions
/accounts/{accountId}/facebook/mentionsPosts that tag the Page. Real-time mentions in comments arrive via the mention webhook. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_user_content. Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call facebook-mentions-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlytextstringread-onlyauthorstringread-onlyauthor_idstringread-onlycreated_atstring (date-time)read-onlyurlstring (uri)read-onlykindstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Reply (Mentions)
/accounts/{accountId}/facebook/mentions/{itemId}/replyReply. Posts that tag the Page. Real-time mentions in comments arrive via the mention webhook. Requires scopes: pages_read_user_content, pages_manage_engagement. Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call facebook-mentions-reply (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≤ 8000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reviews
Facebook Page: List Recommendations
/accounts/{accountId}/facebook/reviewsRatings & recommendations (positive / negative). Reply as the Page or delete the reply. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_user_content. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ratings/ Generic route: /v1/accounts/{accountId}/focus/reviews.
Try it with MCPAsk your agent to call facebook-reviews-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
minRatingintegermaxRatingintegerhasReplybooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringread-onlyopen_graph_story id
ratinginteger | nullread-only1–5
recommendation_typestring | nullread-onlypositivenegative
textstringread-onlyauthorstringread-onlycreated_atstring (date-time)read-onlyreplystring | nullread-onlyreply_idstring | nullread-onlyreplied_atstring (date-time) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Reply (Recommendations)
/accounts/{accountId}/facebook/reviews/{itemId}/replyReply. Ratings & recommendations (positive / negative). Reply as the Page or delete the reply. Requires scopes: pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ratings/ Generic route: /v1/accounts/{accountId}/focus/reviews.
Try it with MCPAsk your agent to call facebook-reviews-reply (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≤ 8000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Delete reply (Recommendations)
/accounts/{accountId}/facebook/reviews/{itemId}/delete-replyDelete reply. Ratings & recommendations (positive / negative). Reply as the Page or delete the reply. Destructive. Requires scopes: pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ratings/ Generic route: /v1/accounts/{accountId}/focus/reviews.
Try it with MCPAsk your agent to call facebook-reviews-delete-reply (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reactions
Facebook Page: List Reactions
/accounts/{accountId}/facebook/reactionsReaction breakdown for a post (object_id); people lists who reacted. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement. Generic route: /v1/accounts/{accountId}/focus/reactions.
Try it with MCPAsk your agent to call facebook-reactions-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
object_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
typestringread-onlyLIKELOVEWOWHAHASADANGRYCARE
countintegerread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: People who reacted (Reactions)
/accounts/{accountId}/facebook/reactions/peoplePeople who reacted. Reaction breakdown for a post (object_id); people lists who reacted. Requires scopes: pages_read_engagement, pages_read_user_content. Generic route: /v1/accounts/{accountId}/focus/reactions.
Try it with MCPAsk your agent to call facebook-reactions-people (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
object_idstringrequiredtypestringLIKELOVEWOWHAHASADANGRYCARE
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Blocked users
Facebook Page: List Blocked people
/accounts/{accountId}/facebook/blocked-usersCursor pagination: pass next_cursor back as cursor. Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/blocked/ Generic route: /v1/accounts/{accountId}/focus/blocked-users.
Try it with MCPAsk your agent to call facebook-blocked-users-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
idstringread-onlynamestringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Blocked people item
/accounts/{accountId}/facebook/blocked-usersBlock people from the Page (Messenger PSIDs, ASIDs or user ids). Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/blocked/ Generic route: /v1/accounts/{accountId}/focus/blocked-users.
Try it with MCPAsk your agent to call facebook-blocked-users-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
idsarray of stringrequired≥ 1 items
idTypestringdefault: "psid"psidasiduser
Returns object
idstringread-onlynamestringread-onlyResponses
Facebook Page: Delete a Blocked people item
/accounts/{accountId}/facebook/blocked-users/{itemId}Unblock. id may be prefixed with psid: / asid: / user: (default user, as returned by the list). Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/blocked/ Generic route: /v1/accounts/{accountId}/focus/blocked-users.
Try it with MCPAsk your agent to call facebook-blocked-users-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Conversations
Facebook Page: List Conversations
/accounts/{accountId}/facebook/conversationsMessenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
folderstringinboxpendingotherpage_donespamrequests
userIdstringPSID
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringread-onlyupdated_atstring (date-time)read-onlyunread_countintegerread-onlylast_messagestringread-onlycustomer_idstringread-onlyPSID
customer_namestringread-onlyparticipantsarray of objectread-onlyShow 2 item attributes
idstringnamestringmessage_countinteger | nullread-onlycan_replyboolean | nullread-onlylinkstring (uri) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Get a Conversations item
/accounts/{accountId}/facebook/conversations/{itemId}Conversation + latest messages + messaging window. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlyupdated_atstring (date-time)read-onlyunread_countintegerread-onlylast_messagestringread-onlycustomer_idstringread-onlyPSID
customer_namestringread-onlyparticipantsarray of objectread-onlyShow 2 item attributes
idstringnamestringmessage_countinteger | nullread-onlycan_replyboolean | nullread-onlylinkstring (uri) | nullread-onlyResponses
Facebook Page: Messages (Conversations)
/accounts/{accountId}/facebook/conversations/{itemId}/messagesMessages. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-messages (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Send message (Conversations)
/accounts/{accountId}/facebook/conversations/{itemId}/sendSend message. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-send (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstring≤ 2000 characters
attachmentsarray of objectMultiple images allowed per message
Show 3 item attributes
typestringimagevideoaudiofile
urlstring (uri)attachmentIdstringquickRepliesarray of object≤ 13 items
Show 4 item attributes
titlestring≤ 20 characters
payloadstringimageUrlstring (uri)typestringtextuser_emailuser_phone_number
buttonsarray of objectSent as a button template (text ≤640 chars)
≤ 3 items
Show 5 item attributes
typestringurlpostbackphone
titlestring≤ 20 characters
urlstring (uri)payloadstringphonestringelementsarray of objectGeneric template (carousel)
≤ 10 items
Show 5 item attributes
titlestring≤ 80 characters
subtitlestring≤ 80 characters
imageUrlstring (uri)urlstring (uri)buttonsarray of object≤ 3 items
imageAspectRatiostringhorizontalsquare
templateobjectRaw template payload (template_type …)
replyTostringmid of the message to reply to
messagingTypestringdefault: "RESPONSE"RESPONSEUPDATEMESSAGE_TAG
tagstringHuman replies 24 h-7 d after the last user message (Human Agent feature)
HUMAN_AGENT
personaIdstringnotificationTypestringREGULARSILENT_PUSHNO_PUSH
recipientIdstringPSID (defaults to the conversation customer)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Typing indicator (Conversations)
/accounts/{accountId}/facebook/conversations/{itemId}/typingTyping indicator. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-typing (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipientIdstringrequiredonbooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Mark seen (Conversations)
/accounts/{accountId}/facebook/conversations/{itemId}/mark-seenMark seen. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-mark-seen (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipientIdstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: React to message (Conversations)
/accounts/{accountId}/facebook/conversations/{itemId}/reactReact to message. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-react (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipientIdstringrequiredmessageIdstringrequiredemojistringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Remove reaction (Conversations)
/accounts/{accountId}/facebook/conversations/{itemId}/unreactRemove reaction. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-unreact (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipientIdstringrequiredmessageIdstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Accept request (Conversations)
/accounts/{accountId}/facebook/conversations/{itemId}/acceptAccept request. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-accept (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipientIdstringrequiredmessagestringrequired≤ 2000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Handover (Conversations)
/accounts/{accountId}/facebook/conversations/{itemId}/thread-controlpass / take / request / release thread control. Page Inbox app id: 263902037430900. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-thread-control (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipientIdstringrequiredactionstringrequiredpasstakerequestrelease
targetAppIdstringmetadatastringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Thread owner (Conversations)
/accounts/{accountId}/facebook/conversations/{itemId}/thread-ownerThread owner. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-thread-owner (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipientIdstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Customer profile (Conversations)
/accounts/{accountId}/facebook/conversations/{itemId}/profileCustomer profile. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-profile (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipientIdstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Upload reusable attachment (Conversations)
/accounts/{accountId}/facebook/conversations/upload-attachmentUpload reusable attachment. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: /v1/accounts/{accountId}/focus/conversations.
Try it with MCPAsk your agent to call facebook-conversations-upload-attachment (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
typestringimagevideoaudiofile
urlstring (uri)requiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Handover apps
Facebook Page: List Handover apps
/accounts/{accountId}/facebook/handover-appsSecondary receivers for the handover protocol (Conversation Routing may disable these APIs). Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/conversation-routing Generic route: /v1/accounts/{accountId}/focus/handover-apps.
Try it with MCPAsk your agent to call facebook-handover-apps-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
idstringread-onlynamestringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Messenger greeting
Facebook Page: Get Greeting
/accounts/{accountId}/facebook/messenger-greetingWelcome-screen greeting per locale (≤160 chars; a "default" locale is required). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-greeting.
Try it with MCPAsk your agent to call facebook-messenger-greeting-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
dataarray of objectShow 2 item attributes
localestringdefault: "default"textstringSupports {{user_first_name}}, {{user_last_name}}, {{user_full_name}}
≤ 160 characters
Responses
Facebook Page: Update Greeting
/accounts/{accountId}/facebook/messenger-greetingWelcome-screen greeting per locale (≤160 chars; a "default" locale is required). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-greeting.
Try it with MCPAsk your agent to call facebook-messenger-greeting-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
greetingarray of objectrequired≥ 1 items
Show 2 item attributes
localestringdefault: "default"textstringSupports {{user_first_name}}, {{user_last_name}}, {{user_full_name}}
≤ 160 characters
Returns object
dataarray of objectShow 2 item attributes
localestringdefault: "default"textstringSupports {{user_first_name}}, {{user_last_name}}, {{user_full_name}}
≤ 160 characters
Responses
Facebook Page: Delete Greeting
/accounts/{accountId}/facebook/messenger-greetingWelcome-screen greeting per locale (≤160 chars; a "default" locale is required). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-greeting.
Try it with MCPAsk your agent to call facebook-messenger-greeting-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Messenger get started
Facebook Page: Get Get Started button
/accounts/{accountId}/facebook/messenger-get-startedPostback payload sent when a user taps Get Started. Required by the persistent menu. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-get-started.
Try it with MCPAsk your agent to call facebook-messenger-get-started-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
dataobject | nullShow 1 child attributes
payloadstringResponses
Facebook Page: Update Get Started button
/accounts/{accountId}/facebook/messenger-get-startedPostback payload sent when a user taps Get Started. Required by the persistent menu. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-get-started.
Try it with MCPAsk your agent to call facebook-messenger-get-started-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
payloadstringrequired≤ 1000 characters
Returns object
dataobject | nullShow 1 child attributes
payloadstringResponses
Facebook Page: Delete Get Started button
/accounts/{accountId}/facebook/messenger-get-startedPostback payload sent when a user taps Get Started. Required by the persistent menu. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-get-started.
Try it with MCPAsk your agent to call facebook-messenger-get-started-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Messenger ice breakers
Facebook Page: Get Ice breakers
/accounts/{accountId}/facebook/messenger-ice-breakersUp to 4 FAQ questions per locale shown when a conversation starts. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-ice-breakers.
Try it with MCPAsk your agent to call facebook-messenger-ice-breakers-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
dataarray of objectShow 2 item attributes
localestringdefault: "default"call_to_actionsarray of object1–4 items
Show 2 item attributes
questionstring≤ 80 characters
payloadstringResponses
Facebook Page: Update Ice breakers
/accounts/{accountId}/facebook/messenger-ice-breakersUp to 4 FAQ questions per locale shown when a conversation starts. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-ice-breakers.
Try it with MCPAsk your agent to call facebook-messenger-ice-breakers-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
ice_breakersarray of objectrequired≥ 1 items
Show 2 item attributes
localestringdefault: "default"call_to_actionsarray of object1–4 items
Show 2 item attributes
questionstring≤ 80 characters
payloadstringReturns object
dataarray of objectShow 2 item attributes
localestringdefault: "default"call_to_actionsarray of object1–4 items
Show 2 item attributes
questionstring≤ 80 characters
payloadstringResponses
Facebook Page: Delete Ice breakers
/accounts/{accountId}/facebook/messenger-ice-breakersUp to 4 FAQ questions per locale shown when a conversation starts. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-ice-breakers.
Try it with MCPAsk your agent to call facebook-messenger-ice-breakers-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Messenger menu
Facebook Page: Get Persistent menu
/accounts/{accountId}/facebook/messenger-menuAlways-on menu (≤20 items per locale). Needs a Get Started button first. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-menu.
Try it with MCPAsk your agent to call facebook-messenger-menu-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
dataarray of objectShow 3 item attributes
localestringdefault: "default"composer_input_disabledbooleandefault: falsecall_to_actionsarray of object1–20 items
Show 6 item attributes
typestringpostbackweb_urlnested
titlestring≤ 30 characters
payloadstringurlstring (uri)webview_height_ratiostringcompacttallfull
call_to_actionsarray of objectNested items (legacy)
Responses
Facebook Page: Update Persistent menu
/accounts/{accountId}/facebook/messenger-menuAlways-on menu (≤20 items per locale). Needs a Get Started button first. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-menu.
Try it with MCPAsk your agent to call facebook-messenger-menu-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
persistent_menuarray of objectrequired≥ 1 items
Show 3 item attributes
localestringdefault: "default"composer_input_disabledbooleandefault: falsecall_to_actionsarray of object1–20 items
Show 6 item attributes
typestringpostbackweb_urlnested
titlestring≤ 30 characters
payloadstringurlstring (uri)webview_height_ratiostringcompacttallfull
call_to_actionsarray of objectNested items (legacy)
Returns object
dataarray of objectShow 3 item attributes
localestringdefault: "default"composer_input_disabledbooleandefault: falsecall_to_actionsarray of object1–20 items
Show 6 item attributes
typestringpostbackweb_urlnested
titlestring≤ 30 characters
payloadstringurlstring (uri)webview_height_ratiostringcompacttallfull
call_to_actionsarray of objectNested items (legacy)
Responses
Facebook Page: Delete Persistent menu
/accounts/{accountId}/facebook/messenger-menuAlways-on menu (≤20 items per locale). Needs a Get Started button first. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-menu.
Try it with MCPAsk your agent to call facebook-messenger-menu-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Messenger domains
Facebook Page: Get Whitelisted domains
/accounts/{accountId}/facebook/messenger-domainsDomains allowed in webviews and URL buttons (https, ≤50). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-domains.
Try it with MCPAsk your agent to call facebook-messenger-domains-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
dataarray of string (uri)Responses
Facebook Page: Update Whitelisted domains
/accounts/{accountId}/facebook/messenger-domainsDomains allowed in webviews and URL buttons (https, ≤50). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-domains.
Try it with MCPAsk your agent to call facebook-messenger-domains-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
whitelisted_domainsarray of string (uri)required≤ 50 items
Returns object
dataarray of string (uri)Responses
Facebook Page: Delete Whitelisted domains
/accounts/{accountId}/facebook/messenger-domainsDomains allowed in webviews and URL buttons (https, ≤50). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: /v1/accounts/{accountId}/focus/messenger-domains.
Try it with MCPAsk your agent to call facebook-messenger-domains-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Personas
Facebook Page: List Personas
/accounts/{accountId}/facebook/personasAgent name + avatar shown on replies (send with personaId). Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/personas Generic route: /v1/accounts/{accountId}/focus/personas.
Try it with MCPAsk your agent to call facebook-personas-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringread-onlynamestringprofile_picture_urlstring (uri)limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Personas item
/accounts/{accountId}/facebook/personasAgent name + avatar shown on replies (send with personaId). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/personas Generic route: /v1/accounts/{accountId}/focus/personas.
Try it with MCPAsk your agent to call facebook-personas-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequiredprofilePictureUrlstring (uri)requiredReturns object
idstringread-onlynamestringprofile_picture_urlstring (uri)Responses
Facebook Page: Get a Personas item
/accounts/{accountId}/facebook/personas/{itemId}Agent name + avatar shown on replies (send with personaId). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/personas Generic route: /v1/accounts/{accountId}/focus/personas.
Try it with MCPAsk your agent to call facebook-personas-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlynamestringprofile_picture_urlstring (uri)Responses
Facebook Page: Delete a Personas item
/accounts/{accountId}/facebook/personas/{itemId}Agent name + avatar shown on replies (send with personaId). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/personas Generic route: /v1/accounts/{accountId}/focus/personas.
Try it with MCPAsk your agent to call facebook-personas-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Labels
Facebook Page: List Inbox labels
/accounts/{accountId}/facebook/labelsCursor pagination: pass next_cursor back as cursor. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: /v1/accounts/{accountId}/focus/labels.
Try it with MCPAsk your agent to call facebook-labels-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
idstringread-onlypage_label_namestringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Inbox labels item
/accounts/{accountId}/facebook/labelsRequires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: /v1/accounts/{accountId}/focus/labels.
Try it with MCPAsk your agent to call facebook-labels-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
page_label_namestringrequiredReturns object
idstringread-onlypage_label_namestringResponses
Facebook Page: Delete a Inbox labels item
/accounts/{accountId}/facebook/labels/{itemId}Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: /v1/accounts/{accountId}/focus/labels.
Try it with MCPAsk your agent to call facebook-labels-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Facebook Page: Assign to person (Inbox labels)
/accounts/{accountId}/facebook/labels/{itemId}/assignAssign to person. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: /v1/accounts/{accountId}/focus/labels.
Try it with MCPAsk your agent to call facebook-labels-assign (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
psidstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Remove from person (Inbox labels)
/accounts/{accountId}/facebook/labels/{itemId}/unassignRemove from person. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: /v1/accounts/{accountId}/focus/labels.
Try it with MCPAsk your agent to call facebook-labels-unassign (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
psidstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Message templates
Facebook Page: List Utility templates
/accounts/{accountId}/facebook/message-templatesTransactional utility templates for messages outside the 24 h window (no promotions). Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_utility_messaging, pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/utility-messages Generic route: /v1/accounts/{accountId}/focus/message-templates.
Try it with MCPAsk your agent to call facebook-message-templates-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlynamestringpattern ^[a-z0-9_]+$
languagestringdefault: "en_US"categorystringUTILITY
statusstringread-onlycomponentsarray of objectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Utility templates item
/accounts/{accountId}/facebook/message-templatesTransactional utility templates for messages outside the 24 h window (no promotions). Requires scopes: pages_utility_messaging, pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/utility-messages Generic route: /v1/accounts/{accountId}/focus/message-templates.
Try it with MCPAsk your agent to call facebook-message-templates-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequiredlanguagestringcategorystringUTILITY
componentsarray of objectrequired≥ 1 items
Returns object
idstringread-onlynamestringpattern ^[a-z0-9_]+$
languagestringdefault: "en_US"categorystringUTILITY
statusstringread-onlycomponentsarray of objectResponses
Facebook Page: Delete a Utility templates item
/accounts/{accountId}/facebook/message-templates/{itemId}Transactional utility templates for messages outside the 24 h window (no promotions). Requires scopes: pages_utility_messaging, pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/utility-messages Generic route: /v1/accounts/{accountId}/focus/message-templates.
Try it with MCPAsk your agent to call facebook-message-templates-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Page insights
Facebook Page: List Overview
/accounts/{accountId}/facebook/page-insightsDaily Page views, viewers, engagement, follows, profile views, video views and actions. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: /v1/accounts/{accountId}/focus/page-insights.
Try it with MCPAsk your agent to call facebook-page-insights-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 30 days ago)
untilstring (date)YYYY-MM-DD (default: today)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
datestring (date)read-onlyimpressionsnumberread-onlyViews (page_media_view)
reachnumberread-onlyViewers (page_total_media_view_unique)
engagementsnumberread-onlyprofile_viewsnumberread-onlyfollowersnumberread-onlyfollower_changenumberread-onlyviewsnumberread-onlyVideo views
watch_time_secondsnumberread-onlyclicksnumberread-onlyCTA + contact clicks
likesnumberread-onlyReactions
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Raw metrics (Zernio page-insights) (Overview)
/accounts/{accountId}/facebook/page-insights/rawRaw metrics (Zernio page-insights). Daily Page views, viewers, engagement, follows, profile views, video views and actions. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: /v1/accounts/{accountId}/focus/page-insights.
Try it with MCPAsk your agent to call facebook-page-insights-raw (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
sincestring (date)YYYY-MM-DD (default: 30 days ago)
untilstring (date)YYYY-MM-DD (default: today)
metricsarray of stringDefault: page_media_view, page_views_total, page_post_engagements, page_video_views, page_video_view_time, page_follows; also followers_gained, followers_lost, content_monetization_earnings, monetization_approximate_earnings, creator_monetization_qualified_views
metricTypestringdefault: "time_series"time_seriestotal_value
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Post insights
Facebook Page: List Post performance
/accounts/{accountId}/facebook/post-insightsViews, viewers, reactions, comments, shares, clicks and video metrics for recent posts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: /v1/accounts/{accountId}/focus/post-insights.
Try it with MCPAsk your agent to call facebook-post-insights-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringread-onlymessagestringread-onlycreated_timestring (date-time)read-onlyimpressionsnumberread-onlyreachnumberread-onlylikesnumberread-onlycommentsnumberread-onlysharesnumberread-onlyclicksnumberread-onlyviewsnumberread-onlyengagementsnumberread-onlyengagement_ratenumberread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Get a Post performance item
/accounts/{accountId}/facebook/post-insights/{itemId}Views, viewers, reactions, comments, shares, clicks and video metrics for recent posts. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: /v1/accounts/{accountId}/focus/post-insights.
Try it with MCPAsk your agent to call facebook-post-insights-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlymessagestringread-onlycreated_timestring (date-time)read-onlyimpressionsnumberread-onlyreachnumberread-onlylikesnumberread-onlycommentsnumberread-onlysharesnumberread-onlyclicksnumberread-onlyviewsnumberread-onlyengagementsnumberread-onlyengagement_ratenumberread-onlyResponses
Video insights
Facebook Page: List Video & Reels
/accounts/{accountId}/facebook/video-insightsDaily Page video metrics; get a video / Reel id for lifetime video_insights (retention, avg watch time). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/video/video_insights/ Generic route: /v1/accounts/{accountId}/focus/video-insights.
Try it with MCPAsk your agent to call facebook-video-insights-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 30 days ago)
untilstring (date)YYYY-MM-DD (default: today)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
datestring (date)read-onlypage_video_viewsnumberread-onlypage_video_views_paidnumberread-onlypage_video_views_organicnumberread-onlypage_video_views_autoplayednumberread-onlypage_video_views_click_to_playnumberread-onlypage_video_repeat_viewsnumberread-onlypage_video_complete_views_30snumberread-onlypage_video_view_timenumberread-onlyms
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Get a Video & Reels item
/accounts/{accountId}/facebook/video-insights/{itemId}Daily Page video metrics; get a video / Reel id for lifetime video_insights (retention, avg watch time). Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/video/video_insights/ Generic route: /v1/accounts/{accountId}/focus/video-insights.
Try it with MCPAsk your agent to call facebook-video-insights-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Query parameters
reelbooleanReturns object
datestring (date)read-onlypage_video_viewsnumberread-onlypage_video_views_paidnumberread-onlypage_video_views_organicnumberread-onlypage_video_views_autoplayednumberread-onlypage_video_views_click_to_playnumberread-onlypage_video_repeat_viewsnumberread-onlypage_video_complete_views_30snumberread-onlypage_video_view_timenumberread-onlyms
Responses
Reaction insights
Facebook Page: List Reactions by type
/accounts/{accountId}/facebook/reaction-insightsCursor pagination: pass next_cursor back as cursor. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: /v1/accounts/{accountId}/focus/reaction-insights.
Try it with MCPAsk your agent to call facebook-reaction-insights-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 30 days ago)
untilstring (date)YYYY-MM-DD (default: today)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
datestring (date)read-onlyLIKEnumberread-onlyLOVEnumberread-onlyWOWnumberread-onlyHAHAnumberread-onlySADnumberread-onlyANGRYnumberread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Demographics
Facebook Page: List Audience
/accounts/{accountId}/facebook/demographicsFollowers by country and city (Meta removed age/gender in Nov 2025). Cursor pagination: pass next_cursor back as cursor. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: /v1/accounts/{accountId}/focus/demographics.
Try it with MCPAsk your agent to call facebook-demographics-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
breakdownstringdefault: "country,city"Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
dimensionstringread-onlycountrycity
keystringread-onlyvaluenumberread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Monetization
Facebook Page: List Monetization
/accounts/{accountId}/facebook/monetizationContent monetization earnings (monetized Pages only). get a post/video id for lifetime post earnings. Cursor pagination: pass next_cursor back as cursor. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: /v1/accounts/{accountId}/focus/monetization.
Try it with MCPAsk your agent to call facebook-monetization-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 30 days ago)
untilstring (date)YYYY-MM-DD (default: today)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
datestring (date)read-onlycontent_monetization_earningsnumberread-onlymonetization_approximate_earningsnumberread-onlycreator_monetization_qualified_viewsnumberread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Get a Monetization item
/accounts/{accountId}/facebook/monetization/{itemId}Content monetization earnings (monetized Pages only). get a post/video id for lifetime post earnings. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: /v1/accounts/{accountId}/focus/monetization.
Try it with MCPAsk your agent to call facebook-monetization-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Query parameters
metricsstringReturns object
datestring (date)read-onlycontent_monetization_earningsnumberread-onlymonetization_approximate_earningsnumberread-onlycreator_monetization_qualified_viewsnumberread-onlyResponses
Page profile
Facebook Page: Get Page info
/accounts/{accountId}/facebook/page-profileAbout, description, contact details, hours, categories, cover and profile picture. Name/username changes are not available via the API. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ Generic route: /v1/accounts/{accountId}/focus/page-profile.
Try it with MCPAsk your agent to call facebook-page-profile-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringread-onlynamestringread-onlyusernamestring | nullread-onlyaboutstring≤ 255 characters
descriptionstringcategorystringread-onlycategory_listarray of objectUp to 3 category ids
≤ 3 items
Show 2 item attributes
idstringnamestringphonestringemailsarray of string (email)websitestring (uri)hoursobjectKeys like mon_1_open / mon_1_close … sun_2_close, values HH:MM
is_always_openbooleantemporary_statusstringdifferently_opentemporarily_closedoperating_as_usualno_data
locationobjectShow 7 child attributes
streetstringcitystringstatestringzipstringcountrystringlatitudenumberlongitudenumbersingle_line_addressstringread-onlyprice_rangestring$$$$$$$$$$Unspecified
picture_urlstring (uri)read-onlycover_urlstring (uri)read-onlyfollowers_countintegerread-onlyfan_countintegerread-onlylinkstring (uri)read-onlyverification_statusstringread-onlyResponses
Facebook Page: Update Page info
/accounts/{accountId}/facebook/page-profileAbout, description, contact details, hours, categories, cover and profile picture. Name/username changes are not available via the API. Requires scopes: pages_read_engagement, pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ Generic route: /v1/accounts/{accountId}/focus/page-profile.
Try it with MCPAsk your agent to call facebook-page-profile-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
aboutstring≤ 255 characters
descriptionstringphonestringemailsarray of string (email)websitestring (uri)hoursobjectKeys like mon_1_open / mon_1_close … sun_2_close, values HH:MM
isAlwaysOpenbooleantemporaryStatusstringdifferently_opentemporarily_closedoperating_as_usualno_data
locationobjectpriceRangestringcategoryListarray of string≤ 3 items
impressumstringmissionstringcompanyOverviewstringgeneralInfostringisPermanentlyClosedbooleanReturns object
idstringread-onlynamestringread-onlyusernamestring | nullread-onlyaboutstring≤ 255 characters
descriptionstringcategorystringread-onlycategory_listarray of objectUp to 3 category ids
≤ 3 items
Show 2 item attributes
idstringnamestringphonestringemailsarray of string (email)websitestring (uri)hoursobjectKeys like mon_1_open / mon_1_close … sun_2_close, values HH:MM
is_always_openbooleantemporary_statusstringdifferently_opentemporarily_closedoperating_as_usualno_data
locationobjectShow 7 child attributes
streetstringcitystringstatestringzipstringcountrystringlatitudenumberlongitudenumbersingle_line_addressstringread-onlyprice_rangestring$$$$$$$$$$Unspecified
picture_urlstring (uri)read-onlycover_urlstring (uri)read-onlyfollowers_countintegerread-onlyfan_countintegerread-onlylinkstring (uri)read-onlyverification_statusstringread-onlyResponses
Facebook Page: Change cover photo (Page info)
/accounts/{accountId}/facebook/page-profile/set-coverChange cover photo. About, description, contact details, hours, categories, cover and profile picture. Name/username changes are not available via the API. Requires scopes: pages_read_engagement, pages_manage_metadata, business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ Generic route: /v1/accounts/{accountId}/focus/page-profile.
Try it with MCPAsk your agent to call facebook-page-profile-set-cover (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediaIdstringurlstring (uri)photoIdstringoffsetYinteger0–100
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Change profile picture (Page info)
/accounts/{accountId}/facebook/page-profile/set-pictureChange profile picture. About, description, contact details, hours, categories, cover and profile picture. Name/username changes are not available via the API. Requires scopes: pages_read_engagement, pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ Generic route: /v1/accounts/{accountId}/focus/page-profile.
Try it with MCPAsk your agent to call facebook-page-profile-set-picture (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediaIdstringurlstring (uri)photoIdstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Page settings
Facebook Page: List Settings
/accounts/{accountId}/facebook/page-settingsCursor pagination: pass next_cursor back as cursor. Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/settings/ Generic route: /v1/accounts/{accountId}/focus/page-settings.
Try it with MCPAsk your agent to call facebook-page-settings-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
settingstringread-onlyvaluestringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Update a Settings item
/accounts/{accountId}/facebook/page-settings/{itemId}Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/settings/ Generic route: /v1/accounts/{accountId}/focus/page-settings.
Try it with MCPAsk your agent to call facebook-page-settings-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
valueanyrequiredReturns object
settingstringread-onlyvaluestringResponses
Call to action
Facebook Page: List Action button
/accounts/{accountId}/facebook/call-to-actionPage CTA button. Reading needs Page Public Content Access; Meta marks updates deprecated (verify in a test app). Creating is not supported. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page-call-to-action/ Generic route: /v1/accounts/{accountId}/focus/call-to-action.
Try it with MCPAsk your agent to call facebook-call-to-action-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringread-onlytypestringBOOK_NOWCALL_NOWCONTACT_USMESSAGESHOP_NOWSIGN_UPLEARN_MOREORDER_FOODVIEW_MENUEMAILGET_DIRECTIONSWATCH_VIDEOPLAY_NOWUSE_APPDONATEGET_QUOTEAPPLY_NOWSEND_MESSAGE
statusstringread-onlyweb_urlstring (uri)email_addressstring (email)intl_number_with_plusstringcreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Update a Action button item
/accounts/{accountId}/facebook/call-to-action/{itemId}Page CTA button. Reading needs Page Public Content Access; Meta marks updates deprecated (verify in a test app). Creating is not supported. Requires scopes: pages_read_engagement, pages_manage_cta. Network docs: https://developers.facebook.com/docs/graph-api/reference/page-call-to-action/ Generic route: /v1/accounts/{accountId}/focus/call-to-action.
Try it with MCPAsk your agent to call facebook-call-to-action-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
typestringBOOK_NOWCALL_NOWCONTACT_USMESSAGESHOP_NOWSIGN_UPLEARN_MOREORDER_FOODVIEW_MENUEMAILGET_DIRECTIONSWATCH_VIDEOPLAY_NOWUSE_APPDONATEGET_QUOTEAPPLY_NOWSEND_MESSAGE
webUrlstring (uri)emailAddressstringphonestringReturns object
idstringread-onlytypestringBOOK_NOWCALL_NOWCONTACT_USMESSAGESHOP_NOWSIGN_UPLEARN_MOREORDER_FOODVIEW_MENUEMAILGET_DIRECTIONSWATCH_VIDEOPLAY_NOWUSE_APPDONATEGET_QUOTEAPPLY_NOWSEND_MESSAGE
statusstringread-onlyweb_urlstring (uri)email_addressstring (email)intl_number_with_plusstringcreated_timestring (date-time)read-onlyupdated_timestring (date-time)read-onlyResponses
Facebook Page: Delete a Action button item
/accounts/{accountId}/facebook/call-to-action/{itemId}Page CTA button. Reading needs Page Public Content Access; Meta marks updates deprecated (verify in a test app). Creating is not supported. Requires scopes: pages_read_engagement, pages_manage_cta. Network docs: https://developers.facebook.com/docs/graph-api/reference/page-call-to-action/ Generic route: /v1/accounts/{accountId}/focus/call-to-action.
Try it with MCPAsk your agent to call facebook-call-to-action-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Webhook subscription
Facebook Page: Get Real-time updates
/accounts/{accountId}/facebook/webhook-subscriptionWhether Socialit receives this Page’s webhooks (feed, mentions, ratings, Messenger). Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/webhooks/reference/page Generic route: /v1/accounts/{accountId}/focus/webhook-subscription.
Try it with MCPAsk your agent to call facebook-webhook-subscription-get (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
pageIdstringread-onlyappSubscribedbooleanread-onlysubscribedFieldsarray of stringread-onlymissingFieldsarray of stringread-onlywarningstring | nullread-onlyResponses
Facebook Page: Re-subscribe (Real-time updates)
/accounts/{accountId}/facebook/webhook-subscription/subscribeRe-subscribe. Whether Socialit receives this Page’s webhooks (feed, mentions, ratings, Messenger). Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/webhooks/reference/page Generic route: /v1/accounts/{accountId}/focus/webhook-subscription.
Try it with MCPAsk your agent to call facebook-webhook-subscription-subscribe (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
scopeSetstringdefault: "core"corefocus
fieldsarray of stringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Facebook Page: Unsubscribe (Real-time updates)
/accounts/{accountId}/facebook/webhook-subscription/unsubscribeUnsubscribe. Whether Socialit receives this Page’s webhooks (feed, mentions, ratings, Messenger). Destructive. Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/webhooks/reference/page Generic route: /v1/accounts/{accountId}/focus/webhook-subscription.
Try it with MCPAsk your agent to call facebook-webhook-subscription-unsubscribe (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Locations
Facebook Page: List Locations
/accounts/{accountId}/facebook/locationsChild location Pages of a multi-location brand. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_read_engagement, business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/locations/ Generic route: /v1/accounts/{accountId}/focus/locations.
Try it with MCPAsk your agent to call facebook-locations-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringOpaque cursor from next_cursor
limitintegerdefault: 251–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringread-onlynamestringread-onlylocationobjectread-onlylinkstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pages
Facebook Page: List Pages
/accounts/{accountId}/facebook/pagesPages available to the connecting user; switch this account to another Page. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pages_show_list. Network docs: https://developers.facebook.com/docs/graph-api/reference/user/accounts/ Generic route: /v1/accounts/{accountId}/focus/pages.
Try it with MCPAsk your agent to call facebook-pages-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringread-onlynamestringread-onlyusernamestring | nullread-onlycategorystringread-onlypicturestring (uri)read-onlytasksarray of stringread-onlycan_publishbooleanread-onlycan_messagebooleanread-onlycan_analyzebooleanread-onlyselectedbooleanread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Use this Page (Pages)
/accounts/{accountId}/facebook/pages/{itemId}/selectReturns the new Page target (externalId + Page token) for the API layer to persist. Pages available to the connecting user; switch this account to another Page. Requires scopes: pages_show_list. Network docs: https://developers.facebook.com/docs/graph-api/reference/user/accounts/ Generic route: /v1/accounts/{accountId}/focus/pages.
Try it with MCPAsk your agent to call facebook-pages-select (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Business partners
Facebook Page: List Partners
/accounts/{accountId}/facebook/business-partnersBusiness portfolios (agencies) this Page is shared with. Cursor pagination: pass next_cursor back as cursor. Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/agencies/ Generic route: /v1/accounts/{accountId}/focus/business-partners.
Try it with MCPAsk your agent to call facebook-business-partners-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringread-onlynamestringread-onlypermittedTasksarray of string | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a Partners item
/accounts/{accountId}/facebook/business-partnersBusiness portfolios (agencies) this Page is shared with. Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/agencies/ Generic route: /v1/accounts/{accountId}/focus/business-partners.
Try it with MCPAsk your agent to call facebook-business-partners-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
businessIdstringrequiredpattern ^\d+$
permittedTasksarray of stringdefault: ["ADVERTISE","ANALYZE"]Returns object
idstringread-onlynamestringread-onlypermittedTasksarray of string | nullread-onlyResponses
Facebook Page: Delete a Partners item
/accounts/{accountId}/facebook/business-partners/{itemId}Business portfolios (agencies) this Page is shared with. Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/agencies/ Generic route: /v1/accounts/{accountId}/focus/business-partners.
Try it with MCPAsk your agent to call facebook-business-partners-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Page roles
Facebook Page: List People & tasks
/accounts/{accountId}/facebook/page-rolesBusiness users with tasks on the Page (business-portfolio Pages). Cursor pagination: pass next_cursor back as cursor. Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/assigned_users/ Generic route: /v1/accounts/{accountId}/focus/page-roles.
Try it with MCPAsk your agent to call facebook-page-roles-list (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
businessIdstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringread-onlynamestringread-onlytasksarray of stringuser_typestring | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Facebook Page: Create a People & tasks item
/accounts/{accountId}/facebook/page-rolesBusiness users with tasks on the Page (business-portfolio Pages). Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/assigned_users/ Generic route: /v1/accounts/{accountId}/focus/page-roles.
Try it with MCPAsk your agent to call facebook-page-roles-create (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
userIdstringrequiredtasksarray of stringrequired≥ 1 items
businessIdstringReturns object
idstringread-onlynamestringread-onlytasksarray of stringuser_typestring | nullread-onlyResponses
Facebook Page: Update a People & tasks item
/accounts/{accountId}/facebook/page-roles/{itemId}Business users with tasks on the Page (business-portfolio Pages). Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/assigned_users/ Generic route: /v1/accounts/{accountId}/focus/page-roles.
Try it with MCPAsk your agent to call facebook-page-roles-update (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
tasksarray of stringrequired≥ 1 items
businessIdstringReturns object
idstringread-onlynamestringread-onlytasksarray of stringuser_typestring | nullread-onlyResponses
Facebook Page: Delete a People & tasks item
/accounts/{accountId}/facebook/page-roles/{itemId}Business users with tasks on the Page (business-portfolio Pages). Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/assigned_users/ Generic route: /v1/accounts/{accountId}/focus/page-roles.
Try it with MCPAsk your agent to call facebook-page-roles-delete (toolset focus_facebook)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultany