Skip to content
Docs

Typed Focus mode operations for Facebook Page accounts, generated from the Facebook Page focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits158 endpointsMCP toolset focus_facebook

Posts

Facebook Page: List Posts

GET/accounts/{accountId}/facebook/posts

Published 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.

Access: read

Try it with MCPAsk your agent to call facebook-posts-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

edgestringdefault: "published_posts"

published_postsfeed

sincestring (date-time)
untilstring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstringread-only
messagestring

≤ 63206 characters

created_timestring (date-time)read-only
updated_timestring (date-time)read-only
scheduled_publish_timestring (date-time) | null
permalink_urlstring (uri)read-only
full_picturestring (uri)read-only
status_typestringread-only
is_publishedbooleanread-only
sharesintegerread-only
reactionsintegerread-only
commentsintegerread-only
fromobjectread-only
Show 2 child attributes
idstring
namestring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Posts item

POST/accounts/{accountId}/facebook/posts

Publish 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.

Access: writeIdempotency-KeyZernio: POST /v1/posts/{postId}/editPOST /v1/posts/{postId}/unpublishPOST /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call facebook-posts-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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
mediaIdstring

Socialit media id

urlstring (uri)
typestring

imagevideo

altTextstring
thumbnailstring (uri)

Video cover URL

subtitlesarray of object
Show 2 item attributes
urlstring (uri)
languagestring
optionsobject
Show 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

pageIdstring

Publish 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.

titlestring

Video / Reel title (separate from the caption).

≤ 255 characters

draftbooleandefault: false

Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.

publishedbooleandefault: true

false = unpublished (same as draft).

scheduledPublishTimestring | integer

Native 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.

geoRestrictionobject

Hard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.

Show 1 child attributes
countriesarray of stringrequired

1–25 items

targetingobject

Raw Graph targeting object (who can see the post). Overrides geoRestriction.

feedTargetingobject

Raw 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.

placestring

Location tag: id of a Page with a location.

pattern ^\d+$

carouselCardsarray of object

Multi-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)required
namestring

Headline (~35 chars shown).

≤ 255 characters

descriptionstring

Subhead (~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).

multiShareOptimizedboolean

Let Facebook reorder carousel cards by performance.

multiShareEndCardboolean

Show the Page end card on carousels.

textFormatPresetIdstring

Text background preset (text-only feed posts; rejected with media, cards, link or empty content).

pattern ^\d+$

callToActionobject

Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)

Show 3 child attributes
typestringrequired

LEARN_MORESHOP_NOWBOOK_TRAVELSIGN_UPDOWNLOADWATCH_MORECONTACT_USAPPLY_NOWGET_DIRECTIONSCALL_NOWMESSAGE_PAGEORDER_NOWSUBSCRIBEGET_QUOTENO_BUTTON

linkstring (uri)
appLinkstring
backdatedTimestring | integer

Backdate a feed/photo post (ISO or unix).

backdatedTimeGranularitystring

yearmonthdayhourminnone

noStoryboolean

Photos/videos: upload without generating a feed story.

altTextstring

Alt text for photos (alt_text_custom). media[].altText wins per image.

firstCommentstring

Comment 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 string

Video content tag ids.

secretboolean

Video: hide from the Page (unlisted).

embeddableboolean

Video: allow embedding.

socialActionsboolean

Video: allow likes/comments/shares.

crosspostToPageIdsarray of string

Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).

crosspostingActionsarray of object

Raw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)

collaboratorsarray of string

Reels: 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

videoStatestring

Reels: explicit video_state (derived from draft/schedule by default).

PUBLISHEDSCHEDULEDDRAFT

waitForUploadbooleandefault: true

Reels/video Stories: poll upload status before finishing.

Returns object

idstringread-only
messagestring

≤ 63206 characters

created_timestring (date-time)read-only
updated_timestring (date-time)read-only
scheduled_publish_timestring (date-time) | null
permalink_urlstring (uri)read-only
full_picturestring (uri)read-only
status_typestringread-only
is_publishedbooleanread-only
sharesintegerread-only
reactionsintegerread-only
commentsintegerread-only
fromobjectread-only
Show 2 child attributes
idstring
namestring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/posts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "media": [
      {
        "mediaId": "string",
        "url": "https://example.com"
      }
    ],
    "options": {
      "contentType": "feed",
      "pageId": "string"
    }
  }'
Response · 201

Facebook Page: Get a Posts item

GET/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.

Access: read

Try it with MCPAsk your agent to call facebook-posts-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
messagestring

≤ 63206 characters

created_timestring (date-time)read-only
updated_timestring (date-time)read-only
scheduled_publish_timestring (date-time) | null
permalink_urlstring (uri)read-only
full_picturestring (uri)read-only
status_typestringread-only
is_publishedbooleanread-only
sharesintegerread-only
reactionsintegerread-only
commentsintegerread-only
fromobjectread-only
Show 2 child attributes
idstring
namestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/posts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update a Posts item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call facebook-posts-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

messagestring

≤ 63206 characters

placestring

Returns object

idstringread-only
messagestring

≤ 63206 characters

created_timestring (date-time)read-only
updated_timestring (date-time)read-only
scheduled_publish_timestring (date-time) | null
permalink_urlstring (uri)read-only
full_picturestring (uri)read-only
status_typestringread-only
is_publishedbooleanread-only
sharesintegerread-only
reactionsintegerread-only
commentsintegerread-only
fromobjectread-only
Show 2 child attributes
idstring
namestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/posts/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "place": "string"
  }'
Response · 200

Facebook Page: Delete a Posts item

DELETE/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.

Access: writeZernio: DELETE /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call facebook-posts-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Like as Page (Posts)

POST/accounts/{accountId}/facebook/posts/{itemId}/like

Like 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-posts-like (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/posts/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Unlike (Posts)

POST/accounts/{accountId}/facebook/posts/{itemId}/unlike

Unlike. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-posts-unlike (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/posts/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Comment as Page (Posts)

POST/accounts/{accountId}/facebook/posts/{itemId}/comment

Comment 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-posts-comment (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/posts/{itemId}/comment
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts/ITEM_ID/comment" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "attachmentUrl": "https://example.com"
  }'
Response · 200

Facebook Page: Reaction breakdown (Posts)

POST/accounts/{accountId}/facebook/posts/{itemId}/reactions

Reaction 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-posts-reactions (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/posts/{itemId}/reactions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts/ITEM_ID/reactions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Post insights (Posts)

POST/accounts/{accountId}/facebook/posts/{itemId}/insights

Post 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-posts-insights (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/posts/{itemId}/insights
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts/ITEM_ID/insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Scheduled posts

Facebook Page: List Scheduled on Facebook

GET/accounts/{accountId}/facebook/scheduled-posts

Posts 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.

Access: read

Try it with MCPAsk your agent to call facebook-scheduled-posts-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstringread-only
messagestring

≤ 63206 characters

created_timestring (date-time)read-only
updated_timestring (date-time)read-only
scheduled_publish_timestring (date-time) | null
permalink_urlstring (uri)read-only
full_picturestring (uri)read-only
status_typestringread-only
is_publishedbooleanread-only
sharesintegerread-only
reactionsintegerread-only
commentsintegerread-only
fromobjectread-only
Show 2 child attributes
idstring
namestring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/scheduled-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/scheduled-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Scheduled on Facebook item

POST/accounts/{accountId}/facebook/scheduled-posts

Schedule 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-scheduled-posts-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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
mediaIdstring

Socialit media id

urlstring (uri)
typestring

imagevideo

altTextstring
thumbnailstring (uri)

Video cover URL

subtitlesarray of object
Show 2 item attributes
urlstring (uri)
languagestring
optionsobject
Show 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

pageIdstring

Publish 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.

titlestring

Video / Reel title (separate from the caption).

≤ 255 characters

draftbooleandefault: false

Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.

publishedbooleandefault: true

false = unpublished (same as draft).

scheduledPublishTimestring | integer

Native 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.

geoRestrictionobject

Hard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.

Show 1 child attributes
countriesarray of stringrequired

1–25 items

targetingobject

Raw Graph targeting object (who can see the post). Overrides geoRestriction.

feedTargetingobject

Raw 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.

placestring

Location tag: id of a Page with a location.

pattern ^\d+$

carouselCardsarray of object

Multi-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)required
namestring

Headline (~35 chars shown).

≤ 255 characters

descriptionstring

Subhead (~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).

multiShareOptimizedboolean

Let Facebook reorder carousel cards by performance.

multiShareEndCardboolean

Show the Page end card on carousels.

textFormatPresetIdstring

Text background preset (text-only feed posts; rejected with media, cards, link or empty content).

pattern ^\d+$

callToActionobject

Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)

Show 3 child attributes
typestringrequired

LEARN_MORESHOP_NOWBOOK_TRAVELSIGN_UPDOWNLOADWATCH_MORECONTACT_USAPPLY_NOWGET_DIRECTIONSCALL_NOWMESSAGE_PAGEORDER_NOWSUBSCRIBEGET_QUOTENO_BUTTON

linkstring (uri)
appLinkstring
backdatedTimestring | integer

Backdate a feed/photo post (ISO or unix).

backdatedTimeGranularitystring

yearmonthdayhourminnone

noStoryboolean

Photos/videos: upload without generating a feed story.

altTextstring

Alt text for photos (alt_text_custom). media[].altText wins per image.

firstCommentstring

Comment 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 string

Video content tag ids.

secretboolean

Video: hide from the Page (unlisted).

embeddableboolean

Video: allow embedding.

socialActionsboolean

Video: allow likes/comments/shares.

crosspostToPageIdsarray of string

Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).

crosspostingActionsarray of object

Raw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)

collaboratorsarray of string

Reels: 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

videoStatestring

Reels: explicit video_state (derived from draft/schedule by default).

PUBLISHEDSCHEDULEDDRAFT

waitForUploadbooleandefault: true

Reels/video Stories: poll upload status before finishing.

Returns object

idstringread-only
messagestring

≤ 63206 characters

created_timestring (date-time)read-only
updated_timestring (date-time)read-only
scheduled_publish_timestring (date-time) | null
permalink_urlstring (uri)read-only
full_picturestring (uri)read-only
status_typestringread-only
is_publishedbooleanread-only
sharesintegerread-only
reactionsintegerread-only
commentsintegerread-only
fromobjectread-only
Show 2 child attributes
idstring
namestring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/scheduled-posts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/scheduled-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "media": [
      {
        "mediaId": "string",
        "url": "https://example.com"
      }
    ],
    "options": {
      "contentType": "feed",
      "pageId": "string"
    }
  }'
Response · 201

Facebook Page: Update a Scheduled on Facebook item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call facebook-scheduled-posts-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

messagestring
scheduled_publish_timestring (date-time)

Returns object

idstringread-only
messagestring

≤ 63206 characters

created_timestring (date-time)read-only
updated_timestring (date-time)read-only
scheduled_publish_timestring (date-time) | null
permalink_urlstring (uri)read-only
full_picturestring (uri)read-only
status_typestringread-only
is_publishedbooleanread-only
sharesintegerread-only
reactionsintegerread-only
commentsintegerread-only
fromobjectread-only
Show 2 child attributes
idstring
namestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/scheduled-posts/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/scheduled-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "scheduled_publish_time": "2026-10-13T09:00:00.000Z"
  }'
Response · 200

Facebook Page: Delete a Scheduled on Facebook item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-scheduled-posts-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/scheduled-posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/scheduled-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Publish now (Scheduled on Facebook)

POST/accounts/{accountId}/facebook/scheduled-posts/{itemId}/publish-now

Publish 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-scheduled-posts-publish-now (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/scheduled-posts/{itemId}/publish-now
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/scheduled-posts/ITEM_ID/publish-now" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Reschedule (Scheduled on Facebook)

POST/accounts/{accountId}/facebook/scheduled-posts/{itemId}/reschedule

Reschedule. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-scheduled-posts-reschedule (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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)required

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/scheduled-posts/{itemId}/reschedule
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/scheduled-posts/ITEM_ID/reschedule" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduled_publish_time": "2026-10-13T09:00:00.000Z"
  }'
Response · 200

Visitor posts

Facebook Page: List Visitor posts

GET/accounts/{accountId}/facebook/visitor-posts

Posts 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.

Access: read

Try it with MCPAsk your agent to call facebook-visitor-posts-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
textstringread-only
authorstringread-only
author_idstringread-only
created_atstring (date-time)read-only
urlstring (uri)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/visitor-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/visitor-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Delete a Visitor posts item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-visitor-posts-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/visitor-posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/visitor-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Reply (Visitor posts)

POST/accounts/{accountId}/facebook/visitor-posts/{itemId}/reply

Reply. Posts by people on the Page. Requires scopes: pages_read_user_content, pages_manage_engagement. Generic route: /v1/accounts/{accountId}/focus/visitor-posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-visitor-posts-reply (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/visitor-posts/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/visitor-posts/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string"
  }'
Response · 200

Photos

Facebook Page: List Photos

GET/accounts/{accountId}/facebook/photos

Cursor 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.

Access: read

Try it with MCPAsk your agent to call facebook-photos-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

typestringdefault: "uploaded"

uploadedtagged

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringread-only
captionstringread-only
alt_textstring

alt_text_custom

created_timestring (date-time)read-only
linkstring (uri)read-only
picturestring (uri)read-only
image_urlstring (uri)read-only
widthintegerread-only
heightintegerread-only
albumobject | nullread-only
Show 2 child attributes
idstring
namestring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/photos
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/photos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Photos item

POST/accounts/{accountId}/facebook/photos

Publish 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-photos-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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
mediaIdstring

Socialit media id

urlstring (uri)
typestring

imagevideo

altTextstring
thumbnailstring (uri)

Video cover URL

subtitlesarray of object
Show 2 item attributes
urlstring (uri)
languagestring
optionsobject
Show 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

pageIdstring

Publish 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.

titlestring

Video / Reel title (separate from the caption).

≤ 255 characters

draftbooleandefault: false

Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.

publishedbooleandefault: true

false = unpublished (same as draft).

scheduledPublishTimestring | integer

Native 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.

geoRestrictionobject

Hard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.

Show 1 child attributes
countriesarray of stringrequired

1–25 items

targetingobject

Raw Graph targeting object (who can see the post). Overrides geoRestriction.

feedTargetingobject

Raw 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.

placestring

Location tag: id of a Page with a location.

pattern ^\d+$

carouselCardsarray of object

Multi-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)required
namestring

Headline (~35 chars shown).

≤ 255 characters

descriptionstring

Subhead (~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).

multiShareOptimizedboolean

Let Facebook reorder carousel cards by performance.

multiShareEndCardboolean

Show the Page end card on carousels.

textFormatPresetIdstring

Text background preset (text-only feed posts; rejected with media, cards, link or empty content).

pattern ^\d+$

callToActionobject

Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)

Show 3 child attributes
typestringrequired

LEARN_MORESHOP_NOWBOOK_TRAVELSIGN_UPDOWNLOADWATCH_MORECONTACT_USAPPLY_NOWGET_DIRECTIONSCALL_NOWMESSAGE_PAGEORDER_NOWSUBSCRIBEGET_QUOTENO_BUTTON

linkstring (uri)
appLinkstring
backdatedTimestring | integer

Backdate a feed/photo post (ISO or unix).

backdatedTimeGranularitystring

yearmonthdayhourminnone

noStoryboolean

Photos/videos: upload without generating a feed story.

altTextstring

Alt text for photos (alt_text_custom). media[].altText wins per image.

firstCommentstring

Comment 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 string

Video content tag ids.

secretboolean

Video: hide from the Page (unlisted).

embeddableboolean

Video: allow embedding.

socialActionsboolean

Video: allow likes/comments/shares.

crosspostToPageIdsarray of string

Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).

crosspostingActionsarray of object

Raw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)

collaboratorsarray of string

Reels: 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

videoStatestring

Reels: explicit video_state (derived from draft/schedule by default).

PUBLISHEDSCHEDULEDDRAFT

waitForUploadbooleandefault: true

Reels/video Stories: poll upload status before finishing.

Returns object

idstringread-only
captionstringread-only
alt_textstring

alt_text_custom

created_timestring (date-time)read-only
linkstring (uri)read-only
picturestring (uri)read-only
image_urlstring (uri)read-only
widthintegerread-only
heightintegerread-only
albumobject | nullread-only
Show 2 child attributes
idstring
namestring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/photos
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/photos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "media": [
      {
        "mediaId": "string",
        "url": "https://example.com"
      }
    ],
    "options": {
      "contentType": "feed",
      "pageId": "string"
    }
  }'
Response · 201

Facebook Page: Get a Photos item

GET/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.

Access: read

Try it with MCPAsk your agent to call facebook-photos-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
captionstringread-only
alt_textstring

alt_text_custom

created_timestring (date-time)read-only
linkstring (uri)read-only
picturestring (uri)read-only
image_urlstring (uri)read-only
widthintegerread-only
heightintegerread-only
albumobject | nullread-only
Show 2 child attributes
idstring
namestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/photos/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/photos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update a Photos item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call facebook-photos-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

alt_textstringrequired

Returns object

idstringread-only
captionstringread-only
alt_textstring

alt_text_custom

created_timestring (date-time)read-only
linkstring (uri)read-only
picturestring (uri)read-only
image_urlstring (uri)read-only
widthintegerread-only
heightintegerread-only
albumobject | nullread-only
Show 2 child attributes
idstring
namestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/photos/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/photos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "alt_text": "string"
  }'
Response · 200

Facebook Page: Delete a Photos item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-photos-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/photos/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/photos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Albums

Facebook Page: List Albums

GET/accounts/{accountId}/facebook/albums

Cursor 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.

Access: read

Try it with MCPAsk your agent to call facebook-albums-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstringread-only
namestring
descriptionstring
countintegerread-only
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
linkstring (uri)read-only
typestringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/albums
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/albums" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Albums item

POST/accounts/{accountId}/facebook/albums

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-albums-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

namestringrequired
descriptionstring
placestring

Returns object

idstringread-only
namestring
descriptionstring
countintegerread-only
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
linkstring (uri)read-only
typestringread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/albums
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/albums" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "place": "string"
  }'
Response · 201

Facebook Page: List photos (Albums)

POST/accounts/{accountId}/facebook/albums/{itemId}/photos

List 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-albums-photos (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/albums/{itemId}/photos
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/albums/ITEM_ID/photos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 25
  }'
Response · 200

Facebook Page: Add photo (Albums)

POST/accounts/{accountId}/facebook/albums/{itemId}/add-photo

Add 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-albums-add-photo (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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)
mediaIdstring
captionstring
altTextstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/albums/{itemId}/add-photo
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/albums/ITEM_ID/add-photo" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "mediaId": "string",
    "caption": "string",
    "altText": "string"
  }'
Response · 200

Videos

Facebook Page: List Videos

GET/accounts/{accountId}/facebook/videos

Feed 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.

Access: read

Try it with MCPAsk your agent to call facebook-videos-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

typestringdefault: "uploaded"

uploadedtagged

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
titlestring

≤ 255 characters

descriptionstring
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
lengthnumberread-only

seconds

permalink_urlstring (uri)read-only
picturestring (uri)read-only
publishedbooleanread-only
statusstringread-only
embeddableboolean
post_idstring | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/videos
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Videos item

POST/accounts/{accountId}/facebook/videos

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-videos-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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
mediaIdstring

Socialit media id

urlstring (uri)
typestring

imagevideo

altTextstring
thumbnailstring (uri)

Video cover URL

subtitlesarray of object
Show 2 item attributes
urlstring (uri)
languagestring
optionsobject
Show 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

pageIdstring

Publish 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.

titlestring

Video / Reel title (separate from the caption).

≤ 255 characters

draftbooleandefault: false

Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.

publishedbooleandefault: true

false = unpublished (same as draft).

scheduledPublishTimestring | integer

Native 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.

geoRestrictionobject

Hard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.

Show 1 child attributes
countriesarray of stringrequired

1–25 items

targetingobject

Raw Graph targeting object (who can see the post). Overrides geoRestriction.

feedTargetingobject

Raw 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.

placestring

Location tag: id of a Page with a location.

pattern ^\d+$

carouselCardsarray of object

Multi-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)required
namestring

Headline (~35 chars shown).

≤ 255 characters

descriptionstring

Subhead (~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).

multiShareOptimizedboolean

Let Facebook reorder carousel cards by performance.

multiShareEndCardboolean

Show the Page end card on carousels.

textFormatPresetIdstring

Text background preset (text-only feed posts; rejected with media, cards, link or empty content).

pattern ^\d+$

callToActionobject

Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)

Show 3 child attributes
typestringrequired

LEARN_MORESHOP_NOWBOOK_TRAVELSIGN_UPDOWNLOADWATCH_MORECONTACT_USAPPLY_NOWGET_DIRECTIONSCALL_NOWMESSAGE_PAGEORDER_NOWSUBSCRIBEGET_QUOTENO_BUTTON

linkstring (uri)
appLinkstring
backdatedTimestring | integer

Backdate a feed/photo post (ISO or unix).

backdatedTimeGranularitystring

yearmonthdayhourminnone

noStoryboolean

Photos/videos: upload without generating a feed story.

altTextstring

Alt text for photos (alt_text_custom). media[].altText wins per image.

firstCommentstring

Comment 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 string

Video content tag ids.

secretboolean

Video: hide from the Page (unlisted).

embeddableboolean

Video: allow embedding.

socialActionsboolean

Video: allow likes/comments/shares.

crosspostToPageIdsarray of string

Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).

crosspostingActionsarray of object

Raw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)

collaboratorsarray of string

Reels: 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

videoStatestring

Reels: explicit video_state (derived from draft/schedule by default).

PUBLISHEDSCHEDULEDDRAFT

waitForUploadbooleandefault: true

Reels/video Stories: poll upload status before finishing.

Returns object

idstringread-only
titlestring

≤ 255 characters

descriptionstring
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
lengthnumberread-only

seconds

permalink_urlstring (uri)read-only
picturestring (uri)read-only
publishedbooleanread-only
statusstringread-only
embeddableboolean
post_idstring | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/videos
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "media": [
      {
        "mediaId": "string",
        "url": "https://example.com"
      }
    ],
    "options": {
      "contentType": "feed",
      "pageId": "string"
    }
  }'
Response · 201

Facebook Page: Get a Videos item

GET/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.

Access: read

Try it with MCPAsk your agent to call facebook-videos-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestring

≤ 255 characters

descriptionstring
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
lengthnumberread-only

seconds

permalink_urlstring (uri)read-only
picturestring (uri)read-only
publishedbooleanread-only
statusstringread-only
embeddableboolean
post_idstring | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/videos/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update a Videos item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call facebook-videos-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring

≤ 255 characters

descriptionstring

Returns object

idstringread-only
titlestring

≤ 255 characters

descriptionstring
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
lengthnumberread-only

seconds

permalink_urlstring (uri)read-only
picturestring (uri)read-only
publishedbooleanread-only
statusstringread-only
embeddableboolean
post_idstring | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/videos/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string"
  }'
Response · 200

Facebook Page: Delete a Videos item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-videos-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/videos/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Video insights (Videos)

POST/accounts/{accountId}/facebook/videos/{itemId}/insights

Video 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-videos-insights (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/videos/{itemId}/insights
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID/insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Thumbnails (Videos)

POST/accounts/{accountId}/facebook/videos/{itemId}/thumbnails

Thumbnails. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-videos-thumbnails (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/videos/{itemId}/thumbnails
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID/thumbnails" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Upload thumbnail (Videos)

POST/accounts/{accountId}/facebook/videos/{itemId}/set-thumbnail

Upload 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-videos-set-thumbnail (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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)
mediaIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/videos/{itemId}/set-thumbnail
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID/set-thumbnail" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "mediaId": "string"
  }'
Response · 200

Facebook Page: Captions (Videos)

POST/accounts/{accountId}/facebook/videos/{itemId}/captions

Captions. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-videos-captions (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/videos/{itemId}/captions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID/captions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Upload captions (.srt) (Videos)

POST/accounts/{accountId}/facebook/videos/{itemId}/add-captions

Upload 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-videos-add-captions (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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)required
languagestringdefault: "en_US"
isDefaultboolean

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/videos/{itemId}/add-captions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID/add-captions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "language": "en_US",
    "isDefault": true
  }'
Response · 200

Facebook Page: Delete captions (Videos)

POST/accounts/{accountId}/facebook/videos/{itemId}/delete-captions

Delete 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.

Access: write

Try it with MCPAsk your agent to call facebook-videos-delete-captions (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

localestringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/videos/{itemId}/delete-captions
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID/delete-captions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "locale": "en"
  }'
Response · 200

Reels

Facebook Page: List Reels

GET/accounts/{accountId}/facebook/reels

Vertical 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.

Access: read

Try it with MCPAsk your agent to call facebook-reels-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

sincestring (date-time)
untilstring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
titlestring

≤ 255 characters

descriptionstring
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
lengthnumberread-only

seconds

permalink_urlstring (uri)read-only
picturestring (uri)read-only
publishedbooleanread-only
statusstringread-only
embeddableboolean
post_idstring | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/reels
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Reels item

POST/accounts/{accountId}/facebook/reels

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-reels-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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
mediaIdstring

Socialit media id

urlstring (uri)
typestring

imagevideo

altTextstring
thumbnailstring (uri)

Video cover URL

subtitlesarray of object
Show 2 item attributes
urlstring (uri)
languagestring
optionsobject
Show 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

pageIdstring

Publish 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.

titlestring

Video / Reel title (separate from the caption).

≤ 255 characters

draftbooleandefault: false

Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.

publishedbooleandefault: true

false = unpublished (same as draft).

scheduledPublishTimestring | integer

Native 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.

geoRestrictionobject

Hard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.

Show 1 child attributes
countriesarray of stringrequired

1–25 items

targetingobject

Raw Graph targeting object (who can see the post). Overrides geoRestriction.

feedTargetingobject

Raw 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.

placestring

Location tag: id of a Page with a location.

pattern ^\d+$

carouselCardsarray of object

Multi-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)required
namestring

Headline (~35 chars shown).

≤ 255 characters

descriptionstring

Subhead (~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).

multiShareOptimizedboolean

Let Facebook reorder carousel cards by performance.

multiShareEndCardboolean

Show the Page end card on carousels.

textFormatPresetIdstring

Text background preset (text-only feed posts; rejected with media, cards, link or empty content).

pattern ^\d+$

callToActionobject

Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)

Show 3 child attributes
typestringrequired

LEARN_MORESHOP_NOWBOOK_TRAVELSIGN_UPDOWNLOADWATCH_MORECONTACT_USAPPLY_NOWGET_DIRECTIONSCALL_NOWMESSAGE_PAGEORDER_NOWSUBSCRIBEGET_QUOTENO_BUTTON

linkstring (uri)
appLinkstring
backdatedTimestring | integer

Backdate a feed/photo post (ISO or unix).

backdatedTimeGranularitystring

yearmonthdayhourminnone

noStoryboolean

Photos/videos: upload without generating a feed story.

altTextstring

Alt text for photos (alt_text_custom). media[].altText wins per image.

firstCommentstring

Comment 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 string

Video content tag ids.

secretboolean

Video: hide from the Page (unlisted).

embeddableboolean

Video: allow embedding.

socialActionsboolean

Video: allow likes/comments/shares.

crosspostToPageIdsarray of string

Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).

crosspostingActionsarray of object

Raw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)

collaboratorsarray of string

Reels: 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

videoStatestring

Reels: explicit video_state (derived from draft/schedule by default).

PUBLISHEDSCHEDULEDDRAFT

waitForUploadbooleandefault: true

Reels/video Stories: poll upload status before finishing.

Returns object

idstringread-only
titlestring

≤ 255 characters

descriptionstring
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
lengthnumberread-only

seconds

permalink_urlstring (uri)read-only
picturestring (uri)read-only
publishedbooleanread-only
statusstringread-only
embeddableboolean
post_idstring | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/reels
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "media": [
      {
        "mediaId": "string",
        "url": "https://example.com"
      }
    ],
    "options": {
      "contentType": "feed",
      "pageId": "string"
    }
  }'
Response · 201

Facebook Page: Get a Reels item

GET/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.

Access: read

Try it with MCPAsk your agent to call facebook-reels-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestring

≤ 255 characters

descriptionstring
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
lengthnumberread-only

seconds

permalink_urlstring (uri)read-only
picturestring (uri)read-only
publishedbooleanread-only
statusstringread-only
embeddableboolean
post_idstring | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/reels/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update a Reels item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call facebook-reels-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring
descriptionstring

Returns object

idstringread-only
titlestring

≤ 255 characters

descriptionstring
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
lengthnumberread-only

seconds

permalink_urlstring (uri)read-only
picturestring (uri)read-only
publishedbooleanread-only
statusstringread-only
embeddableboolean
post_idstring | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/reels/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string"
  }'
Response · 200

Facebook Page: Delete a Reels item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-reels-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/reels/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Reel insights (Reels)

POST/accounts/{accountId}/facebook/reels/{itemId}/insights

Reel 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-reels-insights (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/reels/{itemId}/insights
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels/ITEM_ID/insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Collaborators (Reels)

POST/accounts/{accountId}/facebook/reels/{itemId}/collaborators

Collaborators. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-reels-collaborators (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/reels/{itemId}/collaborators
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels/ITEM_ID/collaborators" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Invite collaborator (Reels)

POST/accounts/{accountId}/facebook/reels/{itemId}/invite-collaborator

Invite 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-reels-invite-collaborator (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

pageIdstringrequired

pattern ^\d+$

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/reels/{itemId}/invite-collaborator
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels/ITEM_ID/invite-collaborator" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "pageId": "string"
  }'
Response · 200

Stories

Facebook Page: List Stories

GET/accounts/{accountId}/facebook/stories

Page 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.

Access: read

Try it with MCPAsk your agent to call facebook-stories-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

sincestring (date-time)
untilstring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
statusstringread-only

PUBLISHEDARCHIVED

media_typestringread-only
media_idstringread-only
urlstring (uri)read-only
created_timestring (date-time)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/stories
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Stories item

POST/accounts/{accountId}/facebook/stories

Page 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-stories-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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 objectrequired

exactly 1 items

Show 6 item attributes
mediaIdstring

Socialit media id

urlstring (uri)
typestring

imagevideo

altTextstring
thumbnailstring (uri)

Video cover URL

subtitlesarray of object
Show 2 item attributes
urlstring (uri)
languagestring

Returns object

idstringread-only
statusstringread-only

PUBLISHEDARCHIVED

media_typestringread-only
media_idstringread-only
urlstring (uri)read-only
created_timestring (date-time)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/stories
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": [
      {
        "mediaId": "string",
        "url": "https://example.com"
      }
    ]
  }'
Response · 201

Facebook Page: Story insights (Stories)

POST/accounts/{accountId}/facebook/stories/{itemId}/insights

Story 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-stories-insights (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/stories/{itemId}/insights
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/stories/ITEM_ID/insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Live videos

Facebook Page: List Live

GET/accounts/{accountId}/facebook/live-videos

Live 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.

Access: read

Try it with MCPAsk your agent to call facebook-live-videos-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

broadcastStatusstring

LIVEUNPUBLISHEDSCHEDULED_UNPUBLISHEDVODPROCESSING

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
titlestring
descriptionstring
statusstring

LIVE_NOWSCHEDULED_UNPUBLISHEDUNPUBLISHEDLIVEVODSCHEDULED_LIVESCHEDULED_CANCELEDPROCESSING

planned_start_timestring (date-time) | null
created_timestring (date-time)read-only
permalink_urlstring (uri)read-only
secure_stream_urlstringread-only

RTMPS URL (server + key)

stream_serverstringread-only
stream_keystring (password)read-only
live_viewsintegerread-only
video_idstring | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/live-videos
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Live item

POST/accounts/{accountId}/facebook/live-videos

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-live-videos-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

titlestring
descriptionstring
statusstringdefault: "UNPUBLISHED"

LIVE_NOWSCHEDULED_UNPUBLISHEDUNPUBLISHED

plannedStartTimestring (date-time)
enableBackupIngestboolean

Returns object

idstringread-only
titlestring
descriptionstring
statusstring

LIVE_NOWSCHEDULED_UNPUBLISHEDUNPUBLISHEDLIVEVODSCHEDULED_LIVESCHEDULED_CANCELEDPROCESSING

planned_start_timestring (date-time) | null
created_timestring (date-time)read-only
permalink_urlstring (uri)read-only
secure_stream_urlstringread-only

RTMPS URL (server + key)

stream_serverstringread-only
stream_keystring (password)read-only
live_viewsintegerread-only
video_idstring | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/live-videos
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "status": "UNPUBLISHED",
    "plannedStartTime": "2026-10-13T09:00:00.000Z",
    "enableBackupIngest": true
  }'
Response · 201

Facebook Page: Get a Live item

GET/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.

Access: read

Try it with MCPAsk your agent to call facebook-live-videos-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestring
descriptionstring
statusstring

LIVE_NOWSCHEDULED_UNPUBLISHEDUNPUBLISHEDLIVEVODSCHEDULED_LIVESCHEDULED_CANCELEDPROCESSING

planned_start_timestring (date-time) | null
created_timestring (date-time)read-only
permalink_urlstring (uri)read-only
secure_stream_urlstringread-only

RTMPS URL (server + key)

stream_serverstringread-only
stream_keystring (password)read-only
live_viewsintegerread-only
video_idstring | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/live-videos/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update a Live item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call facebook-live-videos-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring
descriptionstring
plannedStartTimestring (date-time)

Returns object

idstringread-only
titlestring
descriptionstring
statusstring

LIVE_NOWSCHEDULED_UNPUBLISHEDUNPUBLISHEDLIVEVODSCHEDULED_LIVESCHEDULED_CANCELEDPROCESSING

planned_start_timestring (date-time) | null
created_timestring (date-time)read-only
permalink_urlstring (uri)read-only
secure_stream_urlstringread-only

RTMPS URL (server + key)

stream_serverstringread-only
stream_keystring (password)read-only
live_viewsintegerread-only
video_idstring | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/live-videos/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "plannedStartTime": "2026-10-13T09:00:00.000Z"
  }'
Response · 200

Facebook Page: Delete a Live item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-live-videos-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/live-videos/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Go live (Live)

POST/accounts/{accountId}/facebook/live-videos/{itemId}/go-live

Go 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-live-videos-go-live (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/live-videos/{itemId}/go-live
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos/ITEM_ID/go-live" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: End broadcast (Live)

POST/accounts/{accountId}/facebook/live-videos/{itemId}/end

End 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.

Access: write

Try it with MCPAsk your agent to call facebook-live-videos-end (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/live-videos/{itemId}/end
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos/ITEM_ID/end" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Live comments (Live)

POST/accounts/{accountId}/facebook/live-videos/{itemId}/comments

Live 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-live-videos-comments (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/live-videos/{itemId}/comments
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos/ITEM_ID/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 25
  }'
Response · 200

Crossposting

Facebook Page: List Crossposting

GET/accounts/{accountId}/facebook/crossposting

Video 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.

Access: read

Try it with MCPAsk your agent to call facebook-crossposting-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringread-only
namestringread-only
allows_live_crosspostsboolean | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/crossposting
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/crossposting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Crossposting item

POST/accounts/{accountId}/facebook/crossposting

Request 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-crossposting-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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: true

Returns object

idstringread-only
namestringread-only
allows_live_crosspostsboolean | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/crossposting
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/crossposting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "partnerPageIds": [
      "string"
    ],
    "allowLive": true
  }'
Response · 201

Facebook Page: Accept handshake (Crossposting)

POST/accounts/{accountId}/facebook/crossposting/accept

Accept 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-crossposting-accept (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

partnerPageIdstringrequired
allowLivebooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/crossposting/accept
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/crossposting/accept" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "partnerPageId": "string",
    "allowLive": true
  }'
Response · 200

Facebook Page: Crosspost a video (Crossposting)

POST/accounts/{accountId}/facebook/crossposting/crosspost-video

Crosspost 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-crossposting-crosspost-video (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

videoIdstringrequired
descriptionstring
scheduledPublishTimestring (date-time)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/crossposting/crosspost-video
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/crossposting/crosspost-video" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "videoId": "string",
    "description": "string",
    "scheduledPublishTime": "2026-10-13T09:00:00.000Z"
  }'
Response · 200

Commented posts

Facebook Page: List Posts with comments

GET/accounts/{accountId}/facebook/commented-posts

Recent 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.

Access: readZernio: GET /v1/inbox/comments

Try it with MCPAsk your agent to call facebook-commented-posts-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

sincestring (date-time)
minCommentsinteger

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
messagestringread-only
created_timestring (date-time)read-only
permalink_urlstring (uri)read-only
full_picturestring (uri)read-only
comment_countintegerread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/commented-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/commented-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Comments

Facebook Page: List Comments

GET/accounts/{accountId}/facebook/comments

Comments 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.

Access: read

Try it with MCPAsk your agent to call facebook-comments-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

object_idstringrequired

Post / photo / video / comment id

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

filterstringdefault: "toplevel"

toplevelstream

orderstringdefault: "reverse_chronological"

chronologicalreverse_chronological

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 17 item attributes
idstringread-only
textstring

≤ 8000 characters

authorstringread-only
author_idstringread-only
created_atstring (date-time)read-only
like_countintegerread-only
reply_countintegerread-only
parent_idstring | nullread-only
post_idstring | nullread-only
is_hiddenbooleanread-only
can_hideboolean | nullread-only
can_removeboolean | nullread-only
can_reply_privatelyboolean | nullread-only
liked_by_pagebooleanread-only
from_pagebooleanread-only
attachmentobject | nullread-only
permalink_urlstring (uri) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/comments
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments?object_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Comments item

POST/accounts/{accountId}/facebook/comments

Comment 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.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}POST /v1/inbox/comments/{postId}/{commentId}/hidePOST /v1/inbox/comments/{postId}/{commentId}/likePOST /v1/inbox/comments/{postId}/{commentId}/private-reply

Try it with MCPAsk your agent to call facebook-comments-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
messagestring

≤ 8000 characters

attachmentUrlstring (uri)

Photo / GIF comment

attachmentShareUrlstring (uri)

Returns object

idstringread-only
textstring

≤ 8000 characters

authorstringread-only
author_idstringread-only
created_atstring (date-time)read-only
like_countintegerread-only
reply_countintegerread-only
parent_idstring | nullread-only
post_idstring | nullread-only
is_hiddenbooleanread-only
can_hideboolean | nullread-only
can_removeboolean | nullread-only
can_reply_privatelyboolean | nullread-only
liked_by_pagebooleanread-only
from_pagebooleanread-only
attachmentobject | nullread-only
permalink_urlstring (uri) | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/comments
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "object_id": "string",
    "message": "string",
    "attachmentUrl": "https://example.com",
    "attachmentShareUrl": "https://example.com"
  }'
Response · 201

Facebook Page: Get a Comments item

GET/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.

Access: readZernio: GET /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call facebook-comments-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
textstring

≤ 8000 characters

authorstringread-only
author_idstringread-only
created_atstring (date-time)read-only
like_countintegerread-only
reply_countintegerread-only
parent_idstring | nullread-only
post_idstring | nullread-only
is_hiddenbooleanread-only
can_hideboolean | nullread-only
can_removeboolean | nullread-only
can_reply_privatelyboolean | nullread-only
liked_by_pagebooleanread-only
from_pagebooleanread-only
attachmentobject | nullread-only
permalink_urlstring (uri) | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/comments/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update a Comments item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call facebook-comments-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

textstringrequired

≤ 8000 characters

Returns object

idstringread-only
textstring

≤ 8000 characters

authorstringread-only
author_idstringread-only
created_atstring (date-time)read-only
like_countintegerread-only
reply_countintegerread-only
parent_idstring | nullread-only
post_idstring | nullread-only
is_hiddenbooleanread-only
can_hideboolean | nullread-only
can_removeboolean | nullread-only
can_reply_privatelyboolean | nullread-only
liked_by_pagebooleanread-only
from_pagebooleanread-only
attachmentobject | nullread-only
permalink_urlstring (uri) | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/comments/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
Response · 200

Facebook Page: Delete a Comments item

DELETE/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.

Access: writeZernio: DELETE /v1/inbox/comments/{postId}DELETE /v1/inbox/comments/{postId}/{commentId}/hideDELETE /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call facebook-comments-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/comments/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Reply (Comments)

POST/accounts/{accountId}/facebook/comments/{itemId}/reply

Reply. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-comments-reply (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/comments/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "attachmentUrl": "https://example.com"
  }'
Response · 200

Facebook Page: Hide (Comments)

POST/accounts/{accountId}/facebook/comments/{itemId}/hide

Hide. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-comments-hide (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/comments/{itemId}/hide
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID/hide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Unhide (Comments)

POST/accounts/{accountId}/facebook/comments/{itemId}/unhide

Unhide. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-comments-unhide (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/comments/{itemId}/unhide
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID/unhide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Like (Comments)

POST/accounts/{accountId}/facebook/comments/{itemId}/like

Like. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-comments-like (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/comments/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Unlike (Comments)

POST/accounts/{accountId}/facebook/comments/{itemId}/unlike

Unlike. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-comments-unlike (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/comments/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Facebook Page: Replies (Comments)

POST/accounts/{accountId}/facebook/comments/{itemId}/replies

Replies. 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-comments-replies (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/comments/{itemId}/replies
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID/replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 25
  }'
Response · 200

Facebook Page: Reply privately (Messenger) (Comments)

POST/accounts/{accountId}/facebook/comments/{itemId}/private-reply

One 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-comments-private-reply (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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
titlestring
payloadstring
buttonsarray of object

≤ 3 items

Show 5 item attributes
typestring

urlpostbackphone

titlestring
urlstring (uri)
payloadstring
phonestring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/comments/{itemId}/private-reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID/private-reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "quickReplies": [
      {
        "title": "string",
        "payload": "string"
      }
    ],
    "buttons": [
      {
        "type": "url",
        "title": "string"
      }
    ]
  }'
Response · 200

Mentions

Facebook Page: List Mentions

GET/accounts/{accountId}/facebook/mentions

Posts 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.

Access: readZernio: GET /v1/inbox/mentions

Try it with MCPAsk your agent to call facebook-mentions-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
textstringread-only
authorstringread-only
author_idstringread-only
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/mentions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Reply (Mentions)

POST/accounts/{accountId}/facebook/mentions/{itemId}/reply

Reply. 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.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/mentions/reply

Try it with MCPAsk your agent to call facebook-mentions-reply (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/mentions/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/mentions/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string"
  }'
Response · 200

Reviews

Facebook Page: List Recommendations

GET/accounts/{accountId}/facebook/reviews

Ratings & 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.

Access: readZernio: GET /v1/inbox/reviews

Try it with MCPAsk your agent to call facebook-reviews-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

minRatinginteger
maxRatinginteger
hasReplyboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstringread-only

open_graph_story id

ratinginteger | nullread-only

1–5

recommendation_typestring | nullread-only

positivenegative

textstringread-only
authorstringread-only
created_atstring (date-time)read-only
replystring | nullread-only
reply_idstring | nullread-only
replied_atstring (date-time) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/reviews
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reviews" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Reply (Recommendations)

POST/accounts/{accountId}/facebook/reviews/{itemId}/reply

Reply. 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.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/reviews/{reviewId}/replyDELETE /v1/inbox/reviews/{reviewId}/reply

Try it with MCPAsk your agent to call facebook-reviews-reply (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/reviews/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reviews/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string"
  }'
Response · 200

Facebook Page: Delete reply (Recommendations)

POST/accounts/{accountId}/facebook/reviews/{itemId}/delete-reply

Delete 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.

Access: write

Try it with MCPAsk your agent to call facebook-reviews-delete-reply (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/reviews/{itemId}/delete-reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reviews/ITEM_ID/delete-reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Reactions

Facebook Page: List Reactions

GET/accounts/{accountId}/facebook/reactions

Reaction 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.

Access: readZernio: GET /v1/accounts/{accountId}/facebook-post-reactions

Try it with MCPAsk your agent to call facebook-reactions-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

object_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
typestringread-only

LIKELOVEWOWHAHASADANGRYCARE

countintegerread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/reactions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reactions?object_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: People who reacted (Reactions)

POST/accounts/{accountId}/facebook/reactions/people

People 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-reactions-people (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
typestring

LIKELOVEWOWHAHASADANGRYCARE

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/reactions/people
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reactions/people" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "object_id": "string",
    "type": "LIKE",
    "cursor": "string",
    "limit": 25
  }'
Response · 200

Blocked users

Facebook Page: List Blocked people

GET/accounts/{accountId}/facebook/blocked-users

Cursor 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.

Access: read

Try it with MCPAsk your agent to call facebook-blocked-users-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
idstringread-only
namestringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/blocked-users
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/blocked-users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Blocked people item

POST/accounts/{accountId}/facebook/blocked-users

Block 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-blocked-users-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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-only
namestringread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/blocked-users
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/blocked-users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "string"
    ],
    "idType": "psid"
  }'
Response · 201

Facebook Page: Delete a Blocked people item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-blocked-users-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/blocked-users/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/blocked-users/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Conversations

Facebook Page: List Conversations

GET/accounts/{accountId}/facebook/conversations

Messenger 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.

Access: readZernio: GET /v1/inbox/conversationsGET /v1/inbox/conversations/{conversationId}/messages

Try it with MCPAsk your agent to call facebook-conversations-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

folderstring

inboxpendingotherpage_donespamrequests

userIdstring

PSID

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringread-only
updated_atstring (date-time)read-only
unread_countintegerread-only
last_messagestringread-only
customer_idstringread-only

PSID

customer_namestringread-only
participantsarray of objectread-only
Show 2 item attributes
idstring
namestring
message_countinteger | nullread-only
can_replyboolean | nullread-only
linkstring (uri) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/conversations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Get a Conversations item

GET/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.

Access: readZernio: GET /v1/inbox/conversations/{conversationId}

Try it with MCPAsk your agent to call facebook-conversations-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
updated_atstring (date-time)read-only
unread_countintegerread-only
last_messagestringread-only
customer_idstringread-only

PSID

customer_namestringread-only
participantsarray of objectread-only
Show 2 item attributes
idstring
namestring
message_countinteger | nullread-only
can_replyboolean | nullread-only
linkstring (uri) | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/conversations/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Messages (Conversations)

POST/accounts/{accountId}/facebook/conversations/{itemId}/messages

Messages. 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.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/messagesPOST /v1/inbox/conversations/{conversationId}/typingPOST /v1/inbox/conversations/{conversationId}/readPOST /v1/inbox/conversations/{conversationId}/thread-controlPOST /v1/inbox/conversations/{conversationId}/acceptPOST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactionsDELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions

Try it with MCPAsk your agent to call facebook-conversations-messages (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/{itemId}/messages
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID/messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 25
  }'
Response · 200

Facebook Page: Send message (Conversations)

POST/accounts/{accountId}/facebook/conversations/{itemId}/send

Send 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-conversations-send (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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 object

Multiple images allowed per message

Show 3 item attributes
typestring

imagevideoaudiofile

urlstring (uri)
attachmentIdstring
quickRepliesarray of object

≤ 13 items

Show 4 item attributes
titlestring

≤ 20 characters

payloadstring
imageUrlstring (uri)
typestring

textuser_emailuser_phone_number

buttonsarray of object

Sent as a button template (text ≤640 chars)

≤ 3 items

Show 5 item attributes
typestring

urlpostbackphone

titlestring

≤ 20 characters

urlstring (uri)
payloadstring
phonestring
elementsarray of object

Generic template (carousel)

≤ 10 items

Show 5 item attributes
titlestring

≤ 80 characters

subtitlestring

≤ 80 characters

imageUrlstring (uri)
urlstring (uri)
buttonsarray of object

≤ 3 items

imageAspectRatiostring

horizontalsquare

templateobject

Raw template payload (template_type …)

replyTostring

mid of the message to reply to

messagingTypestringdefault: "RESPONSE"

RESPONSEUPDATEMESSAGE_TAG

tagstring

Human replies 24 h-7 d after the last user message (Human Agent feature)

HUMAN_AGENT

personaIdstring
notificationTypestring

REGULARSILENT_PUSHNO_PUSH

recipientIdstring

PSID (defaults to the conversation customer)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/{itemId}/send
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID/send" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "attachments": [
      {
        "type": "image",
        "url": "https://example.com"
      }
    ],
    "quickReplies": [
      {
        "title": "string",
        "payload": "string"
      }
    ],
    "buttons": [
      {
        "type": "url",
        "title": "string"
      }
    ],
    "elements": [
      {
        "title": "string",
        "subtitle": "string"
      }
    ]
  }'
Response · 200

Facebook Page: Typing indicator (Conversations)

POST/accounts/{accountId}/facebook/conversations/{itemId}/typing

Typing 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-conversations-typing (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

recipientIdstringrequired
onbooleandefault: true

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/{itemId}/typing
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID/typing" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientId": "string",
    "on": true
  }'
Response · 200

Facebook Page: Mark seen (Conversations)

POST/accounts/{accountId}/facebook/conversations/{itemId}/mark-seen

Mark 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-conversations-mark-seen (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

recipientIdstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/{itemId}/mark-seen
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID/mark-seen" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientId": "string"
  }'
Response · 200

Facebook Page: React to message (Conversations)

POST/accounts/{accountId}/facebook/conversations/{itemId}/react

React 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-conversations-react (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

recipientIdstringrequired
messageIdstringrequired
emojistringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/{itemId}/react
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID/react" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientId": "string",
    "messageId": "string",
    "emoji": "string"
  }'
Response · 200

Facebook Page: Remove reaction (Conversations)

POST/accounts/{accountId}/facebook/conversations/{itemId}/unreact

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-conversations-unreact (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

recipientIdstringrequired
messageIdstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/{itemId}/unreact
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID/unreact" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientId": "string",
    "messageId": "string"
  }'
Response · 200

Facebook Page: Accept request (Conversations)

POST/accounts/{accountId}/facebook/conversations/{itemId}/accept

Accept 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-conversations-accept (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

recipientIdstringrequired
messagestringrequired

≤ 2000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/{itemId}/accept
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID/accept" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientId": "string",
    "message": "string"
  }'
Response · 200

Facebook Page: Handover (Conversations)

POST/accounts/{accountId}/facebook/conversations/{itemId}/thread-control

pass / 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-conversations-thread-control (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

recipientIdstringrequired
actionstringrequired

passtakerequestrelease

targetAppIdstring
metadatastring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/{itemId}/thread-control
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID/thread-control" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientId": "string",
    "action": "pass",
    "targetAppId": "string",
    "metadata": "string"
  }'
Response · 200

Facebook Page: Thread owner (Conversations)

POST/accounts/{accountId}/facebook/conversations/{itemId}/thread-owner

Thread 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-conversations-thread-owner (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

recipientIdstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/{itemId}/thread-owner
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID/thread-owner" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientId": "string"
  }'
Response · 200

Facebook Page: Customer profile (Conversations)

POST/accounts/{accountId}/facebook/conversations/{itemId}/profile

Customer 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-conversations-profile (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

recipientIdstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/{itemId}/profile
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientId": "string"
  }'
Response · 200

Facebook Page: Upload reusable attachment (Conversations)

POST/accounts/{accountId}/facebook/conversations/upload-attachment

Upload 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-conversations-upload-attachment (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

typestring

imagevideoaudiofile

urlstring (uri)required

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/conversations/upload-attachment
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/upload-attachment" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "image",
    "url": "https://example.com"
  }'
Response · 200

Handover apps

Facebook Page: List Handover apps

GET/accounts/{accountId}/facebook/handover-apps

Secondary 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.

Access: read

Try it with MCPAsk your agent to call facebook-handover-apps-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
idstringread-only
namestringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/handover-apps
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/handover-apps" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Messenger greeting

Facebook Page: Get Greeting

GET/accounts/{accountId}/facebook/messenger-greeting

Welcome-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.

Access: readZernio: GET /v1/accounts/{accountId}/messenger-greeting

Try it with MCPAsk your agent to call facebook-messenger-greeting-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

dataarray of object
Show 2 item attributes
localestringdefault: "default"
textstring

Supports {{user_first_name}}, {{user_last_name}}, {{user_full_name}}

≤ 160 characters

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/messenger-greeting
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-greeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update Greeting

PATCH/accounts/{accountId}/facebook/messenger-greeting

Welcome-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.

Access: writeZernio: PUT /v1/accounts/{accountId}/messenger-greeting

Try it with MCPAsk your agent to call facebook-messenger-greeting-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

greetingarray of objectrequired

≥ 1 items

Show 2 item attributes
localestringdefault: "default"
textstring

Supports {{user_first_name}}, {{user_last_name}}, {{user_full_name}}

≤ 160 characters

Returns object

dataarray of object
Show 2 item attributes
localestringdefault: "default"
textstring

Supports {{user_first_name}}, {{user_last_name}}, {{user_full_name}}

≤ 160 characters

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/messenger-greeting
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-greeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "greeting": [
      {
        "locale": "default",
        "text": "string"
      }
    ]
  }'
Response · 200

Facebook Page: Delete Greeting

DELETE/accounts/{accountId}/facebook/messenger-greeting

Welcome-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.

Access: writeZernio: DELETE /v1/accounts/{accountId}/messenger-greeting

Try it with MCPAsk your agent to call facebook-messenger-greeting-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/messenger-greeting
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-greeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Messenger get started

Facebook Page: Get Get Started button

GET/accounts/{accountId}/facebook/messenger-get-started

Postback 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.

Access: readZernio: GET /v1/accounts/{accountId}/messenger-get-started

Try it with MCPAsk your agent to call facebook-messenger-get-started-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

dataobject | null
Show 1 child attributes
payloadstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/messenger-get-started
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-get-started" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update Get Started button

PATCH/accounts/{accountId}/facebook/messenger-get-started

Postback 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.

Access: writeZernio: PUT /v1/accounts/{accountId}/messenger-get-started

Try it with MCPAsk your agent to call facebook-messenger-get-started-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

payloadstringrequired

≤ 1000 characters

Returns object

dataobject | null
Show 1 child attributes
payloadstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/messenger-get-started
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-get-started" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": "string"
  }'
Response · 200

Facebook Page: Delete Get Started button

DELETE/accounts/{accountId}/facebook/messenger-get-started

Postback 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.

Access: writeZernio: DELETE /v1/accounts/{accountId}/messenger-get-started

Try it with MCPAsk your agent to call facebook-messenger-get-started-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/messenger-get-started
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-get-started" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Messenger ice breakers

Facebook Page: Get Ice breakers

GET/accounts/{accountId}/facebook/messenger-ice-breakers

Up 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.

Access: readZernio: GET /v1/accounts/{accountId}/messenger-ice-breakers

Try it with MCPAsk your agent to call facebook-messenger-ice-breakers-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

dataarray of object
Show 2 item attributes
localestringdefault: "default"
call_to_actionsarray of object

1–4 items

Show 2 item attributes
questionstring

≤ 80 characters

payloadstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/messenger-ice-breakers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update Ice breakers

PATCH/accounts/{accountId}/facebook/messenger-ice-breakers

Up 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.

Access: writeZernio: PUT /v1/accounts/{accountId}/messenger-ice-breakers

Try it with MCPAsk your agent to call facebook-messenger-ice-breakers-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

ice_breakersarray of objectrequired

≥ 1 items

Show 2 item attributes
localestringdefault: "default"
call_to_actionsarray of object

1–4 items

Show 2 item attributes
questionstring

≤ 80 characters

payloadstring

Returns object

dataarray of object
Show 2 item attributes
localestringdefault: "default"
call_to_actionsarray of object

1–4 items

Show 2 item attributes
questionstring

≤ 80 characters

payloadstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/messenger-ice-breakers
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ice_breakers": [
      {
        "locale": "default",
        "call_to_actions": [
          {
            "question": "string",
            "payload": "string"
          }
        ]
      }
    ]
  }'
Response · 200

Facebook Page: Delete Ice breakers

DELETE/accounts/{accountId}/facebook/messenger-ice-breakers

Up 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.

Access: writeZernio: DELETE /v1/accounts/{accountId}/messenger-ice-breakers

Try it with MCPAsk your agent to call facebook-messenger-ice-breakers-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/messenger-ice-breakers
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Messenger menu

Facebook Page: Get Persistent menu

GET/accounts/{accountId}/facebook/messenger-menu

Always-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.

Access: readZernio: GET /v1/accounts/{accountId}/messenger-menu

Try it with MCPAsk your agent to call facebook-messenger-menu-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

dataarray of object
Show 3 item attributes
localestringdefault: "default"
composer_input_disabledbooleandefault: false
call_to_actionsarray of object

1–20 items

Show 6 item attributes
typestring

postbackweb_urlnested

titlestring

≤ 30 characters

payloadstring
urlstring (uri)
webview_height_ratiostring

compacttallfull

call_to_actionsarray of object

Nested items (legacy)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/messenger-menu
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update Persistent menu

PATCH/accounts/{accountId}/facebook/messenger-menu

Always-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.

Access: writeZernio: PUT /v1/accounts/{accountId}/messenger-menu

Try it with MCPAsk your agent to call facebook-messenger-menu-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

persistent_menuarray of objectrequired

≥ 1 items

Show 3 item attributes
localestringdefault: "default"
composer_input_disabledbooleandefault: false
call_to_actionsarray of object

1–20 items

Show 6 item attributes
typestring

postbackweb_urlnested

titlestring

≤ 30 characters

payloadstring
urlstring (uri)
webview_height_ratiostring

compacttallfull

call_to_actionsarray of object

Nested items (legacy)

Returns object

dataarray of object
Show 3 item attributes
localestringdefault: "default"
composer_input_disabledbooleandefault: false
call_to_actionsarray of object

1–20 items

Show 6 item attributes
typestring

postbackweb_urlnested

titlestring

≤ 30 characters

payloadstring
urlstring (uri)
webview_height_ratiostring

compacttallfull

call_to_actionsarray of object

Nested items (legacy)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/messenger-menu
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "persistent_menu": [
      {
        "locale": "default",
        "composer_input_disabled": false
      }
    ]
  }'
Response · 200

Facebook Page: Delete Persistent menu

DELETE/accounts/{accountId}/facebook/messenger-menu

Always-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.

Access: writeZernio: DELETE /v1/accounts/{accountId}/messenger-menu

Try it with MCPAsk your agent to call facebook-messenger-menu-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/messenger-menu
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Messenger domains

Facebook Page: Get Whitelisted domains

GET/accounts/{accountId}/facebook/messenger-domains

Domains 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.

Access: read

Try it with MCPAsk your agent to call facebook-messenger-domains-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

dataarray of string (uri)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/messenger-domains
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-domains" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update Whitelisted domains

PATCH/accounts/{accountId}/facebook/messenger-domains

Domains 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.

Access: write

Try it with MCPAsk your agent to call facebook-messenger-domains-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

whitelisted_domainsarray of string (uri)required

≤ 50 items

Returns object

dataarray of string (uri)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/messenger-domains
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-domains" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "whitelisted_domains": [
      "https://example.com"
    ]
  }'
Response · 200

Facebook Page: Delete Whitelisted domains

DELETE/accounts/{accountId}/facebook/messenger-domains

Domains 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.

Access: write

Try it with MCPAsk your agent to call facebook-messenger-domains-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/messenger-domains
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-domains" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Personas

Facebook Page: List Personas

GET/accounts/{accountId}/facebook/personas

Agent 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.

Access: read

Try it with MCPAsk your agent to call facebook-personas-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringread-only
namestring
profile_picture_urlstring (uri)
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/personas
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/personas" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Personas item

POST/accounts/{accountId}/facebook/personas

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-personas-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

namestringrequired
profilePictureUrlstring (uri)required

Returns object

idstringread-only
namestring
profile_picture_urlstring (uri)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/personas
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/personas" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "profilePictureUrl": "https://example.com"
  }'
Response · 201

Facebook Page: Get a Personas item

GET/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.

Access: read

Try it with MCPAsk your agent to call facebook-personas-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestring
profile_picture_urlstring (uri)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/personas/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/personas/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Delete a Personas item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-personas-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/personas/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/personas/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Labels

Facebook Page: List Inbox labels

GET/accounts/{accountId}/facebook/labels

Cursor 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.

Access: read

Try it with MCPAsk your agent to call facebook-labels-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
idstringread-only
page_label_namestring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/labels
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/labels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Inbox labels item

POST/accounts/{accountId}/facebook/labels

Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: /v1/accounts/{accountId}/focus/labels.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-labels-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_namestringrequired

Returns object

idstringread-only
page_label_namestring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/labels
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/labels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "page_label_name": "string"
  }'
Response · 201

Facebook Page: Delete a Inbox labels item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-labels-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/labels/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/labels/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Assign to person (Inbox labels)

POST/accounts/{accountId}/facebook/labels/{itemId}/assign

Assign 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-labels-assign (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

psidstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/labels/{itemId}/assign
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/labels/ITEM_ID/assign" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "psid": "string"
  }'
Response · 200

Facebook Page: Remove from person (Inbox labels)

POST/accounts/{accountId}/facebook/labels/{itemId}/unassign

Remove 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-labels-unassign (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

psidstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/labels/{itemId}/unassign
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/labels/ITEM_ID/unassign" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "psid": "string"
  }'
Response · 200

Message templates

Facebook Page: List Utility templates

GET/accounts/{accountId}/facebook/message-templates

Transactional 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.

Access: read

Try it with MCPAsk your agent to call facebook-message-templates-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
namestring

pattern ^[a-z0-9_]+$

languagestringdefault: "en_US"
categorystring

UTILITY

statusstringread-only
componentsarray of object
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/message-templates
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/message-templates" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Utility templates item

POST/accounts/{accountId}/facebook/message-templates

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-message-templates-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

namestringrequired
languagestring
categorystring

UTILITY

componentsarray of objectrequired

≥ 1 items

Returns object

idstringread-only
namestring

pattern ^[a-z0-9_]+$

languagestringdefault: "en_US"
categorystring

UTILITY

statusstringread-only
componentsarray of object

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/message-templates
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/message-templates" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "language": "en",
    "category": "UTILITY",
    "components": [
      {}
    ]
  }'
Response · 201

Facebook Page: Delete a Utility templates item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-message-templates-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/message-templates/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/message-templates/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Page insights

Facebook Page: List Overview

GET/accounts/{accountId}/facebook/page-insights

Daily 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.

Access: readZernio: GET /v1/analytics/facebook/page-insights

Try it with MCPAsk your agent to call facebook-page-insights-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social 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

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
datestring (date)read-only
impressionsnumberread-only

Views (page_media_view)

reachnumberread-only

Viewers (page_total_media_view_unique)

engagementsnumberread-only
profile_viewsnumberread-only
followersnumberread-only
follower_changenumberread-only
viewsnumberread-only

Video views

watch_time_secondsnumberread-only
clicksnumberread-only

CTA + contact clicks

likesnumberread-only

Reactions

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/page-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Raw metrics (Zernio page-insights) (Overview)

POST/accounts/{accountId}/facebook/page-insights/raw

Raw 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-page-insights-raw (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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 string

Default: 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/page-insights/raw
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-insights/raw" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "since": "2026-10-13",
    "until": "2026-10-13",
    "metrics": [
      "string"
    ],
    "metricType": "time_series"
  }'
Response · 200

Post insights

Facebook Page: List Post performance

GET/accounts/{accountId}/facebook/post-insights

Views, 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.

Access: read

Try it with MCPAsk your agent to call facebook-post-insights-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringread-only
messagestringread-only
created_timestring (date-time)read-only
impressionsnumberread-only
reachnumberread-only
likesnumberread-only
commentsnumberread-only
sharesnumberread-only
clicksnumberread-only
viewsnumberread-only
engagementsnumberread-only
engagement_ratenumberread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/post-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/post-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Get a Post performance item

GET/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.

Access: read

Try it with MCPAsk your agent to call facebook-post-insights-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
messagestringread-only
created_timestring (date-time)read-only
impressionsnumberread-only
reachnumberread-only
likesnumberread-only
commentsnumberread-only
sharesnumberread-only
clicksnumberread-only
viewsnumberread-only
engagementsnumberread-only
engagement_ratenumberread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/post-insights/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/post-insights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Video insights

Facebook Page: List Video & Reels

GET/accounts/{accountId}/facebook/video-insights

Daily 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.

Access: read

Try it with MCPAsk your agent to call facebook-video-insights-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social 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

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
datestring (date)read-only
page_video_viewsnumberread-only
page_video_views_paidnumberread-only
page_video_views_organicnumberread-only
page_video_views_autoplayednumberread-only
page_video_views_click_to_playnumberread-only
page_video_repeat_viewsnumberread-only
page_video_complete_views_30snumberread-only
page_video_view_timenumberread-only

ms

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/video-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/video-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Get a Video & Reels item

GET/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.

Access: read

Try it with MCPAsk your agent to call facebook-video-insights-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Query parameters

reelboolean

Returns object

datestring (date)read-only
page_video_viewsnumberread-only
page_video_views_paidnumberread-only
page_video_views_organicnumberread-only
page_video_views_autoplayednumberread-only
page_video_views_click_to_playnumberread-only
page_video_repeat_viewsnumberread-only
page_video_complete_views_30snumberread-only
page_video_view_timenumberread-only

ms

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/video-insights/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/video-insights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reaction insights

Facebook Page: List Reactions by type

GET/accounts/{accountId}/facebook/reaction-insights

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/reaction-insights.

Access: read

Try it with MCPAsk your agent to call facebook-reaction-insights-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social 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

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
datestring (date)read-only
LIKEnumberread-only
LOVEnumberread-only
WOWnumberread-only
HAHAnumberread-only
SADnumberread-only
ANGRYnumberread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/reaction-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reaction-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Demographics

Facebook Page: List Audience

GET/accounts/{accountId}/facebook/demographics

Followers 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.

Access: readZernio: GET /v1/analytics/facebook/demographics

Try it with MCPAsk your agent to call facebook-demographics-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

breakdownstringdefault: "country,city"

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
dimensionstringread-only

countrycity

keystringread-only
valuenumberread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/demographics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/demographics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Monetization

Facebook Page: List Monetization

GET/accounts/{accountId}/facebook/monetization

Content 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.

Access: readZernio: GET /v1/analytics/facebook/post-earnings

Try it with MCPAsk your agent to call facebook-monetization-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social 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

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
datestring (date)read-only
content_monetization_earningsnumberread-only
monetization_approximate_earningsnumberread-only
creator_monetization_qualified_viewsnumberread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/monetization
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/monetization" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Get a Monetization item

GET/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.

Access: read

Try it with MCPAsk your agent to call facebook-monetization-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Query parameters

metricsstring

Returns object

datestring (date)read-only
content_monetization_earningsnumberread-only
monetization_approximate_earningsnumberread-only
creator_monetization_qualified_viewsnumberread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/monetization/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/monetization/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Page profile

Facebook Page: Get Page info

GET/accounts/{accountId}/facebook/page-profile

About, 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.

Access: read

Try it with MCPAsk your agent to call facebook-page-profile-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringread-only
namestringread-only
usernamestring | nullread-only
aboutstring

≤ 255 characters

descriptionstring
categorystringread-only
category_listarray of object

Up to 3 category ids

≤ 3 items

Show 2 item attributes
idstring
namestring
phonestring
emailsarray of string (email)
websitestring (uri)
hoursobject

Keys like mon_1_open / mon_1_close … sun_2_close, values HH:MM

is_always_openboolean
temporary_statusstring

differently_opentemporarily_closedoperating_as_usualno_data

locationobject
Show 7 child attributes
streetstring
citystring
statestring
zipstring
countrystring
latitudenumber
longitudenumber
single_line_addressstringread-only
price_rangestring

$$$$$$$$$$Unspecified

picture_urlstring (uri)read-only
cover_urlstring (uri)read-only
followers_countintegerread-only
fan_countintegerread-only
linkstring (uri)read-only
verification_statusstringread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/page-profile
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update Page info

PATCH/accounts/{accountId}/facebook/page-profile

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.

Access: write

Try it with MCPAsk your agent to call facebook-page-profile-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

aboutstring

≤ 255 characters

descriptionstring
phonestring
emailsarray of string (email)
websitestring (uri)
hoursobject

Keys like mon_1_open / mon_1_close … sun_2_close, values HH:MM

isAlwaysOpenboolean
temporaryStatusstring

differently_opentemporarily_closedoperating_as_usualno_data

locationobject
priceRangestring
categoryListarray of string

≤ 3 items

impressumstring
missionstring
companyOverviewstring
generalInfostring
isPermanentlyClosedboolean

Returns object

idstringread-only
namestringread-only
usernamestring | nullread-only
aboutstring

≤ 255 characters

descriptionstring
categorystringread-only
category_listarray of object

Up to 3 category ids

≤ 3 items

Show 2 item attributes
idstring
namestring
phonestring
emailsarray of string (email)
websitestring (uri)
hoursobject

Keys like mon_1_open / mon_1_close … sun_2_close, values HH:MM

is_always_openboolean
temporary_statusstring

differently_opentemporarily_closedoperating_as_usualno_data

locationobject
Show 7 child attributes
streetstring
citystring
statestring
zipstring
countrystring
latitudenumber
longitudenumber
single_line_addressstringread-only
price_rangestring

$$$$$$$$$$Unspecified

picture_urlstring (uri)read-only
cover_urlstring (uri)read-only
followers_countintegerread-only
fan_countintegerread-only
linkstring (uri)read-only
verification_statusstringread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/page-profile
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "about": "string",
    "description": "string",
    "phone": "+15551234567",
    "emails": [
      "you@example.com"
    ],
    "website": "https://example.com"
  }'
Response · 200

Facebook Page: Change cover photo (Page info)

POST/accounts/{accountId}/facebook/page-profile/set-cover

Change 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-page-profile-set-cover (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

mediaIdstring
urlstring (uri)
photoIdstring
offsetYinteger

0–100

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/page-profile/set-cover
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-profile/set-cover" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "mediaId": "string",
    "url": "https://example.com",
    "photoId": "string",
    "offsetY": 0
  }'
Response · 200

Facebook Page: Change profile picture (Page info)

POST/accounts/{accountId}/facebook/page-profile/set-picture

Change 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-page-profile-set-picture (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

mediaIdstring
urlstring (uri)
photoIdstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/page-profile/set-picture
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-profile/set-picture" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "mediaId": "string",
    "url": "https://example.com",
    "photoId": "string"
  }'
Response · 200

Page settings

Facebook Page: List Settings

GET/accounts/{accountId}/facebook/page-settings

Cursor 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.

Access: read

Try it with MCPAsk your agent to call facebook-page-settings-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
settingstringread-only
valuestring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/page-settings
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update a Settings item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call facebook-page-settings-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

valueanyrequired

Returns object

settingstringread-only
valuestring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/page-settings/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-settings/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "value": null
  }'
Response · 200

Call to action

Facebook Page: List Action button

GET/accounts/{accountId}/facebook/call-to-action

Page 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.

Access: read

Try it with MCPAsk your agent to call facebook-call-to-action-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstringread-only
typestring

BOOK_NOWCALL_NOWCONTACT_USMESSAGESHOP_NOWSIGN_UPLEARN_MOREORDER_FOODVIEW_MENUEMAILGET_DIRECTIONSWATCH_VIDEOPLAY_NOWUSE_APPDONATEGET_QUOTEAPPLY_NOWSEND_MESSAGE

statusstringread-only
web_urlstring (uri)
email_addressstring (email)
intl_number_with_plusstring
created_timestring (date-time)read-only
updated_timestring (date-time)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/call-to-action
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/call-to-action" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Update a Action button item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call facebook-call-to-action-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

typestring

BOOK_NOWCALL_NOWCONTACT_USMESSAGESHOP_NOWSIGN_UPLEARN_MOREORDER_FOODVIEW_MENUEMAILGET_DIRECTIONSWATCH_VIDEOPLAY_NOWUSE_APPDONATEGET_QUOTEAPPLY_NOWSEND_MESSAGE

webUrlstring (uri)
emailAddressstring
phonestring

Returns object

idstringread-only
typestring

BOOK_NOWCALL_NOWCONTACT_USMESSAGESHOP_NOWSIGN_UPLEARN_MOREORDER_FOODVIEW_MENUEMAILGET_DIRECTIONSWATCH_VIDEOPLAY_NOWUSE_APPDONATEGET_QUOTEAPPLY_NOWSEND_MESSAGE

statusstringread-only
web_urlstring (uri)
email_addressstring (email)
intl_number_with_plusstring
created_timestring (date-time)read-only
updated_timestring (date-time)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/call-to-action/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/call-to-action/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "BOOK_NOW",
    "webUrl": "https://example.com",
    "emailAddress": "string",
    "phone": "+15551234567"
  }'
Response · 200

Facebook Page: Delete a Action button item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-call-to-action-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/call-to-action/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/call-to-action/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Webhook subscription

Facebook Page: Get Real-time updates

GET/accounts/{accountId}/facebook/webhook-subscription

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.

Access: readZernio: GET /v1/accounts/{accountId}/webhook-subscription

Try it with MCPAsk your agent to call facebook-webhook-subscription-get (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

pageIdstringread-only
appSubscribedbooleanread-only
subscribedFieldsarray of stringread-only
missingFieldsarray of stringread-only
warningstring | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/webhook-subscription
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/webhook-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Re-subscribe (Real-time updates)

POST/accounts/{accountId}/facebook/webhook-subscription/subscribe

Re-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.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/webhook-subscription

Try it with MCPAsk your agent to call facebook-webhook-subscription-subscribe (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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 string

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/webhook-subscription/subscribe
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/webhook-subscription/subscribe" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "scopeSet": "core",
    "fields": [
      "feed"
    ]
  }'
Response · 200

Facebook Page: Unsubscribe (Real-time updates)

POST/accounts/{accountId}/facebook/webhook-subscription/unsubscribe

Unsubscribe. 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.

Access: write

Try it with MCPAsk your agent to call facebook-webhook-subscription-unsubscribe (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/webhook-subscription/unsubscribe
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/webhook-subscription/unsubscribe" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Locations

Facebook Page: List Locations

GET/accounts/{accountId}/facebook/locations

Child 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.

Access: read

Try it with MCPAsk your agent to call facebook-locations-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Opaque cursor from next_cursor

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringread-only
namestringread-only
locationobjectread-only
linkstring (uri)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/locations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pages

Facebook Page: List Pages

GET/accounts/{accountId}/facebook/pages

Pages 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.

Access: readZernio: GET /v1/accounts/{accountId}/facebook-pageGET /v1/connect/facebook/select-page

Try it with MCPAsk your agent to call facebook-pages-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringread-only
namestringread-only
usernamestring | nullread-only
categorystringread-only
picturestring (uri)read-only
tasksarray of stringread-only
can_publishbooleanread-only
can_messagebooleanread-only
can_analyzebooleanread-only
selectedbooleanread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/pages
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/pages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Use this Page (Pages)

POST/accounts/{accountId}/facebook/pages/{itemId}/select

Returns 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.

Access: writeIdempotency-KeyZernio: PUT /v1/accounts/{accountId}/facebook-pagePOST /v1/connect/facebook/select-page

Try it with MCPAsk your agent to call facebook-pages-select (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/pages/{itemId}/select
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/pages/ITEM_ID/select" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Business partners

Facebook Page: List Partners

GET/accounts/{accountId}/facebook/business-partners

Business 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.

Access: readZernio: GET /v1/accounts/{accountId}/business-partners

Try it with MCPAsk your agent to call facebook-business-partners-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringread-only
namestringread-only
permittedTasksarray of string | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/business-partners
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/business-partners" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a Partners item

POST/accounts/{accountId}/facebook/business-partners

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.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/business-partners

Try it with MCPAsk your agent to call facebook-business-partners-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

businessIdstringrequired

pattern ^\d+$

permittedTasksarray of stringdefault: ["ADVERTISE","ANALYZE"]

Returns object

idstringread-only
namestringread-only
permittedTasksarray of string | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/business-partners
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/business-partners" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "businessId": "string",
    "permittedTasks": [
      "ADVERTISE",
      "ANALYZE"
    ]
  }'
Response · 201

Facebook Page: Delete a Partners item

DELETE/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.

Access: writeZernio: DELETE /v1/accounts/{accountId}/business-partners

Try it with MCPAsk your agent to call facebook-business-partners-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/business-partners/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/business-partners/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Page roles

Facebook Page: List People & tasks

GET/accounts/{accountId}/facebook/page-roles

Business 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.

Access: read

Try it with MCPAsk your agent to call facebook-page-roles-list (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

businessIdstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringread-only
namestringread-only
tasksarray of string
user_typestring | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/facebook/page-roles
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-roles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Facebook Page: Create a People & tasks item

POST/accounts/{accountId}/facebook/page-roles

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call facebook-page-roles-create (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

userIdstringrequired
tasksarray of stringrequired

≥ 1 items

businessIdstring

Returns object

idstringread-only
namestringread-only
tasksarray of string
user_typestring | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/facebook/page-roles
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-roles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "string",
    "tasks": [
      "MANAGE"
    ],
    "businessId": "string"
  }'
Response · 201

Facebook Page: Update a People & tasks item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call facebook-page-roles-update (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

tasksarray of stringrequired

≥ 1 items

businessIdstring

Returns object

idstringread-only
namestringread-only
tasksarray of string
user_typestring | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/facebook/page-roles/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-roles/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tasks": [
      "MANAGE"
    ],
    "businessId": "string"
  }'
Response · 200

Facebook Page: Delete a People & tasks item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call facebook-page-roles-delete (toolset focus_facebook)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/facebook/page-roles/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-roles/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200