# Focus · Facebook Page API

> 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 URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## 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` · MCP tool: `facebook-posts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)
- `edge` (string; one of published_posts, feed)
- `since` (string (date-time))
- `until` (string (date-time))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "message": "string",
      "created_time": "2026-10-13T09:00:00.000Z",
      "updated_time": "2026-10-13T09:00:00.000Z",
      "scheduled_publish_time": "2026-10-13T09:00:00.000Z",
      "permalink_url": "https://example.com",
      "full_picture": "https://example.com",
      "status_type": "string",
      "is_published": true,
      "shares": 1,
      "reactions": 1,
      "comments": 1,
      "from": {
        "id": "string",
        "name": "string"
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-posts-create` · Zernio: `POST /v1/posts/{postId}/edit`, `POST /v1/posts/{postId}/unpublish`, `POST /v1/inbox/posts/{postId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `content` (string; ≤ 63206 characters)
- `media` (array of object; ≤ 10 items)
  - `media[].mediaId` (string): Socialit media id
  - `media[].url` (string (uri))
  - `media[].type` (string; one of image, video)
  - `media[].altText` (string)
  - `media[].thumbnail` (string (uri)): Video cover URL
  - `media[].subtitles` (array of object)
    - `media[].subtitles[].url` (string (uri))
    - `media[].subtitles[].language` (string)
- `options` (object)
  - `options.contentType` (string; one of feed, reel, story): 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.
  - `options.pageId` (string; pattern ^\d+$): Publish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token.
  - `options.link` (string (uri)): Link to share (feed text posts). Generates a link preview.
  - `options.title` (string; ≤ 255 characters): Video / Reel title (separate from the caption).
  - `options.draft` (boolean): Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.
  - `options.published` (boolean): false = unpublished (same as draft).
  - `options.scheduledPublishTime` (string | 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.
  - `options.geoRestriction` (object): Hard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.
    - `options.geoRestriction.countries` (array of string; required; 1–25 items)
  - `options.targeting` (object): Raw Graph targeting object (who can see the post). Overrides geoRestriction.
  - `options.feedTargeting` (object): 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.
  - `options.place` (string; pattern ^\d+$): Location tag: id of a Page with a location.
  - `options.carouselCards` (array of object; 2–10 items): Multi-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.
    - `options.carouselCards[].link` (string (uri); required)
    - `options.carouselCards[].name` (string; ≤ 255 characters): Headline (~35 chars shown).
    - `options.carouselCards[].description` (string; ≤ 255 characters): Subhead (~30 chars shown).
    - `options.carouselCards[].picture` (string (uri)): Card image URL (defaults to media[i].url).
  - `options.carouselLink` (string (uri)): "See more" end-card URL (defaults to the first card link).
  - `options.multiShareOptimized` (boolean): Let Facebook reorder carousel cards by performance.
  - `options.multiShareEndCard` (boolean): Show the Page end card on carousels.
  - `options.textFormatPresetId` (string; pattern ^\d+$): Text background preset (text-only feed posts; rejected with media, cards, link or empty content).
  - `options.callToAction` (object): Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)
    - `options.callToAction.type` (string; required; one of LEARN_MORE, SHOP_NOW, BOOK_TRAVEL, SIGN_UP, DOWNLOAD, WATCH_MORE, CONTACT_US, APPLY_NOW, GET_DIRECTIONS, CALL_NOW, MESSAGE_PAGE, ORDER_NOW, …)
    - `options.callToAction.link` (string (uri))
    - `options.callToAction.appLink` (string)
  - `options.backdatedTime` (string | integer): Backdate a feed/photo post (ISO or unix).
  - `options.backdatedTimeGranularity` (string; one of year, month, day, hour, min, none)
  - `options.noStory` (boolean): Photos/videos: upload without generating a feed story.
  - `options.altText` (string): Alt text for photos (alt_text_custom). media[].altText wins per image.
  - `options.firstComment` (string; ≤ 8000 characters): Comment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules).
  - `options.thumbnailUrl` (string (uri)): Custom video / Reel cover (≤10 MB). media[].thumbnail wins.
  - `options.contentTags` (array of string): Video content tag ids.
  - `options.secret` (boolean): Video: hide from the Page (unlisted).
  - `options.embeddable` (boolean): Video: allow embedding.
  - `options.socialActions` (boolean): Video: allow likes/comments/shares.
  - `options.crosspostToPageIds` (array of string): Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).
  - `options.crosspostingActions` (array of object): Raw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)
  - `options.collaborators` (array of string): Reels: Page ids to invite as collaborators (10 invites / Page / 24 h).
  - `options.uploadMode` (string; one of auto, url, resumable): Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided.
  - `options.videoState` (string; one of PUBLISHED, SCHEDULED, DRAFT): Reels: explicit video_state (derived from draft/schedule by default).
  - `options.waitForUpload` (boolean): Reels/video Stories: poll upload status before finishing.

```bash
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:

```json
{
  "id": "string",
  "message": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "scheduled_publish_time": "2026-10-13T09:00:00.000Z",
  "permalink_url": "https://example.com",
  "full_picture": "https://example.com",
  "status_type": "string",
  "is_published": true,
  "shares": 1,
  "reactions": 1,
  "comments": 1,
  "from": {
    "id": "string",
    "name": "string"
  }
}
```

## 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` · MCP tool: `facebook-posts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "message": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "scheduled_publish_time": "2026-10-13T09:00:00.000Z",
  "permalink_url": "https://example.com",
  "full_picture": "https://example.com",
  "status_type": "string",
  "is_published": true,
  "shares": 1,
  "reactions": 1,
  "comments": 1,
  "from": {
    "id": "string",
    "name": "string"
  }
}
```

## 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` · MCP tool: `facebook-posts-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `message` (string; ≤ 63206 characters)
- `place` (string)

```bash
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:

```json
{
  "id": "string",
  "message": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "scheduled_publish_time": "2026-10-13T09:00:00.000Z",
  "permalink_url": "https://example.com",
  "full_picture": "https://example.com",
  "status_type": "string",
  "is_published": true,
  "shares": 1,
  "reactions": 1,
  "comments": 1,
  "from": {
    "id": "string",
    "name": "string"
  }
}
```

## 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: `write` · MCP tool: `facebook-posts-delete` · Zernio: `DELETE /v1/inbox/posts/{postId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-posts-like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-posts-unlike`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-posts-comment`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `message` (string; required; ≤ 8000 characters)
- `attachmentUrl` (string (uri))

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-posts-reactions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-posts-insights`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-scheduled-posts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/scheduled-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "message": "string",
      "created_time": "2026-10-13T09:00:00.000Z",
      "updated_time": "2026-10-13T09:00:00.000Z",
      "scheduled_publish_time": "2026-10-13T09:00:00.000Z",
      "permalink_url": "https://example.com",
      "full_picture": "https://example.com",
      "status_type": "string",
      "is_published": true,
      "shares": 1,
      "reactions": 1,
      "comments": 1,
      "from": {
        "id": "string",
        "name": "string"
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-scheduled-posts-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `content` (string; ≤ 63206 characters)
- `media` (array of object; ≤ 10 items)
  - `media[].mediaId` (string): Socialit media id
  - `media[].url` (string (uri))
  - `media[].type` (string; one of image, video)
  - `media[].altText` (string)
  - `media[].thumbnail` (string (uri)): Video cover URL
  - `media[].subtitles` (array of object)
    - `media[].subtitles[].url` (string (uri))
    - `media[].subtitles[].language` (string)
- `options` (object)
  - `options.contentType` (string; one of feed, reel, story): 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.
  - `options.pageId` (string; pattern ^\d+$): Publish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token.
  - `options.link` (string (uri)): Link to share (feed text posts). Generates a link preview.
  - `options.title` (string; ≤ 255 characters): Video / Reel title (separate from the caption).
  - `options.draft` (boolean): Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.
  - `options.published` (boolean): false = unpublished (same as draft).
  - `options.scheduledPublishTime` (string | 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.
  - `options.geoRestriction` (object): Hard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.
    - `options.geoRestriction.countries` (array of string; required; 1–25 items)
  - `options.targeting` (object): Raw Graph targeting object (who can see the post). Overrides geoRestriction.
  - `options.feedTargeting` (object): 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.
  - `options.place` (string; pattern ^\d+$): Location tag: id of a Page with a location.
  - `options.carouselCards` (array of object; 2–10 items): Multi-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.
    - `options.carouselCards[].link` (string (uri); required)
    - `options.carouselCards[].name` (string; ≤ 255 characters): Headline (~35 chars shown).
    - `options.carouselCards[].description` (string; ≤ 255 characters): Subhead (~30 chars shown).
    - `options.carouselCards[].picture` (string (uri)): Card image URL (defaults to media[i].url).
  - `options.carouselLink` (string (uri)): "See more" end-card URL (defaults to the first card link).
  - `options.multiShareOptimized` (boolean): Let Facebook reorder carousel cards by performance.
  - `options.multiShareEndCard` (boolean): Show the Page end card on carousels.
  - `options.textFormatPresetId` (string; pattern ^\d+$): Text background preset (text-only feed posts; rejected with media, cards, link or empty content).
  - `options.callToAction` (object): Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)
    - `options.callToAction.type` (string; required; one of LEARN_MORE, SHOP_NOW, BOOK_TRAVEL, SIGN_UP, DOWNLOAD, WATCH_MORE, CONTACT_US, APPLY_NOW, GET_DIRECTIONS, CALL_NOW, MESSAGE_PAGE, ORDER_NOW, …)
    - `options.callToAction.link` (string (uri))
    - `options.callToAction.appLink` (string)
  - `options.backdatedTime` (string | integer): Backdate a feed/photo post (ISO or unix).
  - `options.backdatedTimeGranularity` (string; one of year, month, day, hour, min, none)
  - `options.noStory` (boolean): Photos/videos: upload without generating a feed story.
  - `options.altText` (string): Alt text for photos (alt_text_custom). media[].altText wins per image.
  - `options.firstComment` (string; ≤ 8000 characters): Comment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules).
  - `options.thumbnailUrl` (string (uri)): Custom video / Reel cover (≤10 MB). media[].thumbnail wins.
  - `options.contentTags` (array of string): Video content tag ids.
  - `options.secret` (boolean): Video: hide from the Page (unlisted).
  - `options.embeddable` (boolean): Video: allow embedding.
  - `options.socialActions` (boolean): Video: allow likes/comments/shares.
  - `options.crosspostToPageIds` (array of string): Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).
  - `options.crosspostingActions` (array of object): Raw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)
  - `options.collaborators` (array of string): Reels: Page ids to invite as collaborators (10 invites / Page / 24 h).
  - `options.uploadMode` (string; one of auto, url, resumable): Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided.
  - `options.videoState` (string; one of PUBLISHED, SCHEDULED, DRAFT): Reels: explicit video_state (derived from draft/schedule by default).
  - `options.waitForUpload` (boolean): Reels/video Stories: poll upload status before finishing.

```bash
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:

```json
{
  "id": "string",
  "message": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "scheduled_publish_time": "2026-10-13T09:00:00.000Z",
  "permalink_url": "https://example.com",
  "full_picture": "https://example.com",
  "status_type": "string",
  "is_published": true,
  "shares": 1,
  "reactions": 1,
  "comments": 1,
  "from": {
    "id": "string",
    "name": "string"
  }
}
```

## 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` · MCP tool: `facebook-scheduled-posts-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `message` (string)
- `scheduled_publish_time` (string (date-time))

```bash
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:

```json
{
  "id": "string",
  "message": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "scheduled_publish_time": "2026-10-13T09:00:00.000Z",
  "permalink_url": "https://example.com",
  "full_picture": "https://example.com",
  "status_type": "string",
  "is_published": true,
  "shares": 1,
  "reactions": 1,
  "comments": 1,
  "from": {
    "id": "string",
    "name": "string"
  }
}
```

## 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` · MCP tool: `facebook-scheduled-posts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/scheduled-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-scheduled-posts-publish-now`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-scheduled-posts-reschedule`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `scheduled_publish_time` (string (date-time); required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-visitor-posts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/visitor-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `facebook-visitor-posts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/visitor-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-visitor-posts-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `message` (string; required; ≤ 8000 characters)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-photos-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)
- `type` (string; one of uploaded, tagged)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/photos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "caption": "string",
      "alt_text": "string",
      "created_time": "2026-10-13T09:00:00.000Z",
      "link": "https://example.com",
      "picture": "https://example.com",
      "image_url": "https://example.com",
      "width": 1,
      "height": 1,
      "album": {
        "id": "string",
        "name": "string"
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-photos-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `content` (string; ≤ 63206 characters)
- `media` (array of object; ≤ 10 items)
  - `media[].mediaId` (string): Socialit media id
  - `media[].url` (string (uri))
  - `media[].type` (string; one of image, video)
  - `media[].altText` (string)
  - `media[].thumbnail` (string (uri)): Video cover URL
  - `media[].subtitles` (array of object)
    - `media[].subtitles[].url` (string (uri))
    - `media[].subtitles[].language` (string)
- `options` (object)
  - `options.contentType` (string; one of feed, reel, story): 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.
  - `options.pageId` (string; pattern ^\d+$): Publish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token.
  - `options.link` (string (uri)): Link to share (feed text posts). Generates a link preview.
  - `options.title` (string; ≤ 255 characters): Video / Reel title (separate from the caption).
  - `options.draft` (boolean): Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.
  - `options.published` (boolean): false = unpublished (same as draft).
  - `options.scheduledPublishTime` (string | 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.
  - `options.geoRestriction` (object): Hard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.
    - `options.geoRestriction.countries` (array of string; required; 1–25 items)
  - `options.targeting` (object): Raw Graph targeting object (who can see the post). Overrides geoRestriction.
  - `options.feedTargeting` (object): 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.
  - `options.place` (string; pattern ^\d+$): Location tag: id of a Page with a location.
  - `options.carouselCards` (array of object; 2–10 items): Multi-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.
    - `options.carouselCards[].link` (string (uri); required)
    - `options.carouselCards[].name` (string; ≤ 255 characters): Headline (~35 chars shown).
    - `options.carouselCards[].description` (string; ≤ 255 characters): Subhead (~30 chars shown).
    - `options.carouselCards[].picture` (string (uri)): Card image URL (defaults to media[i].url).
  - `options.carouselLink` (string (uri)): "See more" end-card URL (defaults to the first card link).
  - `options.multiShareOptimized` (boolean): Let Facebook reorder carousel cards by performance.
  - `options.multiShareEndCard` (boolean): Show the Page end card on carousels.
  - `options.textFormatPresetId` (string; pattern ^\d+$): Text background preset (text-only feed posts; rejected with media, cards, link or empty content).
  - `options.callToAction` (object): Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)
    - `options.callToAction.type` (string; required; one of LEARN_MORE, SHOP_NOW, BOOK_TRAVEL, SIGN_UP, DOWNLOAD, WATCH_MORE, CONTACT_US, APPLY_NOW, GET_DIRECTIONS, CALL_NOW, MESSAGE_PAGE, ORDER_NOW, …)
    - `options.callToAction.link` (string (uri))
    - `options.callToAction.appLink` (string)
  - `options.backdatedTime` (string | integer): Backdate a feed/photo post (ISO or unix).
  - `options.backdatedTimeGranularity` (string; one of year, month, day, hour, min, none)
  - `options.noStory` (boolean): Photos/videos: upload without generating a feed story.
  - `options.altText` (string): Alt text for photos (alt_text_custom). media[].altText wins per image.
  - `options.firstComment` (string; ≤ 8000 characters): Comment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules).
  - `options.thumbnailUrl` (string (uri)): Custom video / Reel cover (≤10 MB). media[].thumbnail wins.
  - `options.contentTags` (array of string): Video content tag ids.
  - `options.secret` (boolean): Video: hide from the Page (unlisted).
  - `options.embeddable` (boolean): Video: allow embedding.
  - `options.socialActions` (boolean): Video: allow likes/comments/shares.
  - `options.crosspostToPageIds` (array of string): Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).
  - `options.crosspostingActions` (array of object): Raw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)
  - `options.collaborators` (array of string): Reels: Page ids to invite as collaborators (10 invites / Page / 24 h).
  - `options.uploadMode` (string; one of auto, url, resumable): Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided.
  - `options.videoState` (string; one of PUBLISHED, SCHEDULED, DRAFT): Reels: explicit video_state (derived from draft/schedule by default).
  - `options.waitForUpload` (boolean): Reels/video Stories: poll upload status before finishing.

```bash
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:

```json
{
  "id": "string",
  "caption": "string",
  "alt_text": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "link": "https://example.com",
  "picture": "https://example.com",
  "image_url": "https://example.com",
  "width": 1,
  "height": 1,
  "album": {
    "id": "string",
    "name": "string"
  }
}
```

## 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` · MCP tool: `facebook-photos-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/photos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "caption": "string",
  "alt_text": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "link": "https://example.com",
  "picture": "https://example.com",
  "image_url": "https://example.com",
  "width": 1,
  "height": 1,
  "album": {
    "id": "string",
    "name": "string"
  }
}
```

## 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` · MCP tool: `facebook-photos-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `alt_text` (string; required)

```bash
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:

```json
{
  "id": "string",
  "caption": "string",
  "alt_text": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "link": "https://example.com",
  "picture": "https://example.com",
  "image_url": "https://example.com",
  "width": 1,
  "height": 1,
  "album": {
    "id": "string",
    "name": "string"
  }
}
```

## 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` · MCP tool: `facebook-photos-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/photos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `facebook-albums-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/albums" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "count": 1,
      "created_time": "2026-10-13T09:00:00.000Z",
      "updated_time": "2026-10-13T09:00:00.000Z",
      "link": "https://example.com",
      "type": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-albums-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `name` (string; required)
- `description` (string)
- `place` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "count": 1,
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "link": "https://example.com",
  "type": "string"
}
```

## 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: `write` · MCP tool: `facebook-albums-photos`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-albums-add-photo`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `url` (string (uri))
- `mediaId` (string)
- `caption` (string)
- `altText` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-videos-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)
- `type` (string; one of uploaded, tagged)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "created_time": "2026-10-13T09:00:00.000Z",
      "updated_time": "2026-10-13T09:00:00.000Z",
      "length": 1.5,
      "permalink_url": "https://example.com",
      "picture": "https://example.com",
      "published": true,
      "status": "string",
      "embeddable": true,
      "post_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-videos-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `content` (string; ≤ 63206 characters)
- `media` (array of object; ≤ 10 items)
  - `media[].mediaId` (string): Socialit media id
  - `media[].url` (string (uri))
  - `media[].type` (string; one of image, video)
  - `media[].altText` (string)
  - `media[].thumbnail` (string (uri)): Video cover URL
  - `media[].subtitles` (array of object)
    - `media[].subtitles[].url` (string (uri))
    - `media[].subtitles[].language` (string)
- `options` (object)
  - `options.contentType` (string; one of feed, reel, story): 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.
  - `options.pageId` (string; pattern ^\d+$): Publish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token.
  - `options.link` (string (uri)): Link to share (feed text posts). Generates a link preview.
  - `options.title` (string; ≤ 255 characters): Video / Reel title (separate from the caption).
  - `options.draft` (boolean): Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.
  - `options.published` (boolean): false = unpublished (same as draft).
  - `options.scheduledPublishTime` (string | 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.
  - `options.geoRestriction` (object): Hard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.
    - `options.geoRestriction.countries` (array of string; required; 1–25 items)
  - `options.targeting` (object): Raw Graph targeting object (who can see the post). Overrides geoRestriction.
  - `options.feedTargeting` (object): 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.
  - `options.place` (string; pattern ^\d+$): Location tag: id of a Page with a location.
  - `options.carouselCards` (array of object; 2–10 items): Multi-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.
    - `options.carouselCards[].link` (string (uri); required)
    - `options.carouselCards[].name` (string; ≤ 255 characters): Headline (~35 chars shown).
    - `options.carouselCards[].description` (string; ≤ 255 characters): Subhead (~30 chars shown).
    - `options.carouselCards[].picture` (string (uri)): Card image URL (defaults to media[i].url).
  - `options.carouselLink` (string (uri)): "See more" end-card URL (defaults to the first card link).
  - `options.multiShareOptimized` (boolean): Let Facebook reorder carousel cards by performance.
  - `options.multiShareEndCard` (boolean): Show the Page end card on carousels.
  - `options.textFormatPresetId` (string; pattern ^\d+$): Text background preset (text-only feed posts; rejected with media, cards, link or empty content).
  - `options.callToAction` (object): Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)
    - `options.callToAction.type` (string; required; one of LEARN_MORE, SHOP_NOW, BOOK_TRAVEL, SIGN_UP, DOWNLOAD, WATCH_MORE, CONTACT_US, APPLY_NOW, GET_DIRECTIONS, CALL_NOW, MESSAGE_PAGE, ORDER_NOW, …)
    - `options.callToAction.link` (string (uri))
    - `options.callToAction.appLink` (string)
  - `options.backdatedTime` (string | integer): Backdate a feed/photo post (ISO or unix).
  - `options.backdatedTimeGranularity` (string; one of year, month, day, hour, min, none)
  - `options.noStory` (boolean): Photos/videos: upload without generating a feed story.
  - `options.altText` (string): Alt text for photos (alt_text_custom). media[].altText wins per image.
  - `options.firstComment` (string; ≤ 8000 characters): Comment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules).
  - `options.thumbnailUrl` (string (uri)): Custom video / Reel cover (≤10 MB). media[].thumbnail wins.
  - `options.contentTags` (array of string): Video content tag ids.
  - `options.secret` (boolean): Video: hide from the Page (unlisted).
  - `options.embeddable` (boolean): Video: allow embedding.
  - `options.socialActions` (boolean): Video: allow likes/comments/shares.
  - `options.crosspostToPageIds` (array of string): Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).
  - `options.crosspostingActions` (array of object): Raw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)
  - `options.collaborators` (array of string): Reels: Page ids to invite as collaborators (10 invites / Page / 24 h).
  - `options.uploadMode` (string; one of auto, url, resumable): Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided.
  - `options.videoState` (string; one of PUBLISHED, SCHEDULED, DRAFT): Reels: explicit video_state (derived from draft/schedule by default).
  - `options.waitForUpload` (boolean): Reels/video Stories: poll upload status before finishing.

```bash
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:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "length": 1.5,
  "permalink_url": "https://example.com",
  "picture": "https://example.com",
  "published": true,
  "status": "string",
  "embeddable": true,
  "post_id": "string"
}
```

## 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` · MCP tool: `facebook-videos-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "length": 1.5,
  "permalink_url": "https://example.com",
  "picture": "https://example.com",
  "published": true,
  "status": "string",
  "embeddable": true,
  "post_id": "string"
}
```

## 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` · MCP tool: `facebook-videos-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string; ≤ 255 characters)
- `description` (string)

```bash
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:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "length": 1.5,
  "permalink_url": "https://example.com",
  "picture": "https://example.com",
  "published": true,
  "status": "string",
  "embeddable": true,
  "post_id": "string"
}
```

## 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` · MCP tool: `facebook-videos-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-videos-insights`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-videos-thumbnails`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-videos-set-thumbnail`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `url` (string (uri))
- `mediaId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-videos-captions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-videos-add-captions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `url` (string (uri); required)
- `language` (string)
- `isDefault` (boolean)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-videos-delete-captions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `locale` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-reels-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)
- `since` (string (date-time))
- `until` (string (date-time))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "created_time": "2026-10-13T09:00:00.000Z",
      "updated_time": "2026-10-13T09:00:00.000Z",
      "length": 1.5,
      "permalink_url": "https://example.com",
      "picture": "https://example.com",
      "published": true,
      "status": "string",
      "embeddable": true,
      "post_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-reels-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `content` (string; ≤ 63206 characters)
- `media` (array of object; ≤ 10 items)
  - `media[].mediaId` (string): Socialit media id
  - `media[].url` (string (uri))
  - `media[].type` (string; one of image, video)
  - `media[].altText` (string)
  - `media[].thumbnail` (string (uri)): Video cover URL
  - `media[].subtitles` (array of object)
    - `media[].subtitles[].url` (string (uri))
    - `media[].subtitles[].language` (string)
- `options` (object)
  - `options.contentType` (string; one of feed, reel, story): 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.
  - `options.pageId` (string; pattern ^\d+$): Publish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token.
  - `options.link` (string (uri)): Link to share (feed text posts). Generates a link preview.
  - `options.title` (string; ≤ 255 characters): Video / Reel title (separate from the caption).
  - `options.draft` (boolean): Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped.
  - `options.published` (boolean): false = unpublished (same as draft).
  - `options.scheduledPublishTime` (string | 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.
  - `options.geoRestriction` (object): Hard visibility restriction (Graph targeting.geo_locations.countries). Feed posts, videos, Reels.
    - `options.geoRestriction.countries` (array of string; required; 1–25 items)
  - `options.targeting` (object): Raw Graph targeting object (who can see the post). Overrides geoRestriction.
  - `options.feedTargeting` (object): 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.
  - `options.place` (string; pattern ^\d+$): Location tag: id of a Page with a location.
  - `options.carouselCards` (array of object; 2–10 items): Multi-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.
    - `options.carouselCards[].link` (string (uri); required)
    - `options.carouselCards[].name` (string; ≤ 255 characters): Headline (~35 chars shown).
    - `options.carouselCards[].description` (string; ≤ 255 characters): Subhead (~30 chars shown).
    - `options.carouselCards[].picture` (string (uri)): Card image URL (defaults to media[i].url).
  - `options.carouselLink` (string (uri)): "See more" end-card URL (defaults to the first card link).
  - `options.multiShareOptimized` (boolean): Let Facebook reorder carousel cards by performance.
  - `options.multiShareEndCard` (boolean): Show the Page end card on carousels.
  - `options.textFormatPresetId` (string; pattern ^\d+$): Text background preset (text-only feed posts; rejected with media, cards, link or empty content).
  - `options.callToAction` (object): Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)
    - `options.callToAction.type` (string; required; one of LEARN_MORE, SHOP_NOW, BOOK_TRAVEL, SIGN_UP, DOWNLOAD, WATCH_MORE, CONTACT_US, APPLY_NOW, GET_DIRECTIONS, CALL_NOW, MESSAGE_PAGE, ORDER_NOW, …)
    - `options.callToAction.link` (string (uri))
    - `options.callToAction.appLink` (string)
  - `options.backdatedTime` (string | integer): Backdate a feed/photo post (ISO or unix).
  - `options.backdatedTimeGranularity` (string; one of year, month, day, hour, min, none)
  - `options.noStory` (boolean): Photos/videos: upload without generating a feed story.
  - `options.altText` (string): Alt text for photos (alt_text_custom). media[].altText wins per image.
  - `options.firstComment` (string; ≤ 8000 characters): Comment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules).
  - `options.thumbnailUrl` (string (uri)): Custom video / Reel cover (≤10 MB). media[].thumbnail wins.
  - `options.contentTags` (array of string): Video content tag ids.
  - `options.secret` (boolean): Video: hide from the Page (unlisted).
  - `options.embeddable` (boolean): Video: allow embedding.
  - `options.socialActions` (boolean): Video: allow likes/comments/shares.
  - `options.crosspostToPageIds` (array of string): Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship).
  - `options.crosspostingActions` (array of object): Raw Graph crossposting_actions ([{ page_id, action }]); overrides crosspostToPageIds. (verify)
  - `options.collaborators` (array of string): Reels: Page ids to invite as collaborators (10 invites / Page / 24 h).
  - `options.uploadMode` (string; one of auto, url, resumable): Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided.
  - `options.videoState` (string; one of PUBLISHED, SCHEDULED, DRAFT): Reels: explicit video_state (derived from draft/schedule by default).
  - `options.waitForUpload` (boolean): Reels/video Stories: poll upload status before finishing.

```bash
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:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "length": 1.5,
  "permalink_url": "https://example.com",
  "picture": "https://example.com",
  "published": true,
  "status": "string",
  "embeddable": true,
  "post_id": "string"
}
```

## 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` · MCP tool: `facebook-reels-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "length": 1.5,
  "permalink_url": "https://example.com",
  "picture": "https://example.com",
  "published": true,
  "status": "string",
  "embeddable": true,
  "post_id": "string"
}
```

## 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` · MCP tool: `facebook-reels-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string)
- `description` (string)

```bash
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:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z",
  "length": 1.5,
  "permalink_url": "https://example.com",
  "picture": "https://example.com",
  "published": true,
  "status": "string",
  "embeddable": true,
  "post_id": "string"
}
```

## 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` · MCP tool: `facebook-reels-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reels/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-reels-insights`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-reels-collaborators`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-reels-invite-collaborator`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `pageId` (string; required; pattern ^\d+$)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-stories-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)
- `since` (string (date-time))
- `until` (string (date-time))

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "status": "PUBLISHED",
      "media_type": "string",
      "media_id": "string",
      "url": "https://example.com",
      "created_time": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-stories-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `media` (array of object; required; exactly 1 items)
  - `media[].mediaId` (string): Socialit media id
  - `media[].url` (string (uri))
  - `media[].type` (string; one of image, video)
  - `media[].altText` (string)
  - `media[].thumbnail` (string (uri)): Video cover URL
  - `media[].subtitles` (array of object)
    - `media[].subtitles[].url` (string (uri))
    - `media[].subtitles[].language` (string)

```bash
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:

```json
{
  "id": "string",
  "status": "PUBLISHED",
  "media_type": "string",
  "media_id": "string",
  "url": "https://example.com",
  "created_time": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `facebook-stories-insights`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-live-videos-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)
- `broadcastStatus` (string; one of LIVE, UNPUBLISHED, SCHEDULED_UNPUBLISHED, VOD, PROCESSING)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "status": "LIVE_NOW",
      "planned_start_time": "2026-10-13T09:00:00.000Z",
      "created_time": "2026-10-13T09:00:00.000Z",
      "permalink_url": "https://example.com",
      "secure_stream_url": "https://example.com",
      "stream_server": "string",
      "stream_key": "string",
      "live_views": 1,
      "video_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-live-videos-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `title` (string)
- `description` (string)
- `status` (string; one of LIVE_NOW, SCHEDULED_UNPUBLISHED, UNPUBLISHED)
- `plannedStartTime` (string (date-time))
- `enableBackupIngest` (boolean)

```bash
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:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "status": "LIVE_NOW",
  "planned_start_time": "2026-10-13T09:00:00.000Z",
  "created_time": "2026-10-13T09:00:00.000Z",
  "permalink_url": "https://example.com",
  "secure_stream_url": "https://example.com",
  "stream_server": "string",
  "stream_key": "string",
  "live_views": 1,
  "video_id": "string"
}
```

## 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` · MCP tool: `facebook-live-videos-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "status": "LIVE_NOW",
  "planned_start_time": "2026-10-13T09:00:00.000Z",
  "created_time": "2026-10-13T09:00:00.000Z",
  "permalink_url": "https://example.com",
  "secure_stream_url": "https://example.com",
  "stream_server": "string",
  "stream_key": "string",
  "live_views": 1,
  "video_id": "string"
}
```

## 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` · MCP tool: `facebook-live-videos-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string)
- `description` (string)
- `plannedStartTime` (string (date-time))

```bash
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:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "status": "LIVE_NOW",
  "planned_start_time": "2026-10-13T09:00:00.000Z",
  "created_time": "2026-10-13T09:00:00.000Z",
  "permalink_url": "https://example.com",
  "secure_stream_url": "https://example.com",
  "stream_server": "string",
  "stream_key": "string",
  "live_views": 1,
  "video_id": "string"
}
```

## 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` · MCP tool: `facebook-live-videos-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/live-videos/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-live-videos-go-live`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-live-videos-end`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-live-videos-comments`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-crossposting-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/crossposting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "allows_live_crossposts": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-crossposting-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `partnerPageIds` (array of string; required; ≥ 1 items)
- `allowLive` (boolean)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "allows_live_crossposts": true
}
```

## 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: `write` · MCP tool: `facebook-crossposting-accept`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `partnerPageId` (string; required)
- `allowLive` (boolean)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-crossposting-crosspost-video`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `videoId` (string; required)
- `description` (string)
- `scheduledPublishTime` (string (date-time))

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-commented-posts-list` · Zernio: `GET /v1/inbox/comments`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)
- `since` (string (date-time))
- `minComments` (integer)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/commented-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "message": "string",
      "created_time": "2026-10-13T09:00:00.000Z",
      "permalink_url": "https://example.com",
      "full_picture": "https://example.com",
      "comment_count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `facebook-comments-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `object_id` (string; required): Post / photo / video / comment id
- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)
- `filter` (string; one of toplevel, stream)
- `order` (string; one of chronological, reverse_chronological)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments?object_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "reply_count": 1,
      "parent_id": "string",
      "post_id": "string",
      "is_hidden": true,
      "can_hide": true,
      "can_remove": true,
      "can_reply_privately": true,
      "liked_by_page": true,
      "from_page": true,
      "attachment": {},
      "permalink_url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-comments-create` · Zernio: `POST /v1/inbox/comments/{postId}`, `POST /v1/inbox/comments/{postId}/{commentId}/hide`, `POST /v1/inbox/comments/{postId}/{commentId}/like`, `POST /v1/inbox/comments/{postId}/{commentId}/private-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `object_id` (string; required)
- `message` (string; ≤ 8000 characters)
- `attachmentUrl` (string (uri)): Photo / GIF comment
- `attachmentShareUrl` (string (uri))

```bash
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:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "author_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reply_count": 1,
  "parent_id": "string",
  "post_id": "string",
  "is_hidden": true,
  "can_hide": true,
  "can_remove": true,
  "can_reply_privately": true,
  "liked_by_page": true,
  "from_page": true,
  "attachment": {},
  "permalink_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `facebook-comments-get` · Zernio: `GET /v1/inbox/comments/{postId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "author_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reply_count": 1,
  "parent_id": "string",
  "post_id": "string",
  "is_hidden": true,
  "can_hide": true,
  "can_remove": true,
  "can_reply_privately": true,
  "liked_by_page": true,
  "from_page": true,
  "attachment": {},
  "permalink_url": "https://example.com"
}
```

## 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` · MCP tool: `facebook-comments-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `text` (string; required; ≤ 8000 characters)

```bash
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:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "author_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "reply_count": 1,
  "parent_id": "string",
  "post_id": "string",
  "is_hidden": true,
  "can_hide": true,
  "can_remove": true,
  "can_reply_privately": true,
  "liked_by_page": true,
  "from_page": true,
  "attachment": {},
  "permalink_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-comments-delete` · Zernio: `DELETE /v1/inbox/comments/{postId}`, `DELETE /v1/inbox/comments/{postId}/{commentId}/hide`, `DELETE /v1/inbox/comments/{postId}/{commentId}/like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/comments/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-comments-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `message` (string; required; ≤ 8000 characters)
- `attachmentUrl` (string (uri))

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-comments-hide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-comments-unhide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-comments-like`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-comments-unlike`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-comments-replies`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-comments-private-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `message` (string; required; ≤ 2000 characters)
- `quickReplies` (array of object; ≤ 13 items)
  - `quickReplies[].title` (string)
  - `quickReplies[].payload` (string)
- `buttons` (array of object; ≤ 3 items)
  - `buttons[].type` (string; one of url, postback, phone)
  - `buttons[].title` (string)
  - `buttons[].url` (string (uri))
  - `buttons[].payload` (string)
  - `buttons[].phone` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-mentions-list` · Zernio: `GET /v1/inbox/mentions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "kind": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-mentions-reply` · Zernio: `POST /v1/inbox/mentions/reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `message` (string; required; ≤ 8000 characters)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-reviews-list` · Zernio: `GET /v1/inbox/reviews`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)
- `minRating` (integer)
- `maxRating` (integer)
- `hasReply` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reviews" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "rating": 1,
      "recommendation_type": "positive",
      "text": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "reply": "string",
      "reply_id": "string",
      "replied_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-reviews-reply` · Zernio: `POST /v1/inbox/reviews/{reviewId}/reply`, `DELETE /v1/inbox/reviews/{reviewId}/reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `message` (string; required; ≤ 8000 characters)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-reviews-delete-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-reactions-list` · Zernio: `GET /v1/accounts/{accountId}/facebook-post-reactions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `object_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reactions?object_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "type": "LIKE",
      "count": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-reactions-people`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `object_id` (string; required)
- `type` (string; one of LIKE, LOVE, WOW, HAHA, SAD, ANGRY, CARE)
- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-blocked-users-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/blocked-users" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-blocked-users-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `ids` (array of string; required; ≥ 1 items)
- `idType` (string; one of psid, asid, user)

```bash
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:

```json
{
  "id": "string",
  "name": "string"
}
```

## 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` · MCP tool: `facebook-blocked-users-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/blocked-users/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-conversations-list` · Zernio: `GET /v1/inbox/conversations`, `GET /v1/inbox/conversations/{conversationId}/messages`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)
- `folder` (string; one of inbox, pending, other, page_done, spam, requests)
- `userId` (string): PSID

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "updated_at": "2026-10-13T09:00:00.000Z",
      "unread_count": 1,
      "last_message": "string",
      "customer_id": "string",
      "customer_name": "string",
      "participants": [
        {
          "id": "string",
          "name": "string"
        }
      ],
      "message_count": 1,
      "can_reply": true,
      "link": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `facebook-conversations-get` · Zernio: `GET /v1/inbox/conversations/{conversationId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/conversations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "last_message": "string",
  "customer_id": "string",
  "customer_name": "string",
  "participants": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "message_count": 1,
  "can_reply": true,
  "link": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-conversations-messages` · Zernio: `POST /v1/inbox/conversations/{conversationId}/messages`, `POST /v1/inbox/conversations/{conversationId}/typing`, `POST /v1/inbox/conversations/{conversationId}/read`, `POST /v1/inbox/conversations/{conversationId}/thread-control`, `POST /v1/inbox/conversations/{conversationId}/accept`, `POST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions`, `DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-conversations-send`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; ≤ 2000 characters)
- `attachments` (array of object): Multiple images allowed per message
  - `attachments[].type` (string; one of image, video, audio, file)
  - `attachments[].url` (string (uri))
  - `attachments[].attachmentId` (string)
- `quickReplies` (array of object; ≤ 13 items)
  - `quickReplies[].title` (string; ≤ 20 characters)
  - `quickReplies[].payload` (string)
  - `quickReplies[].imageUrl` (string (uri))
  - `quickReplies[].type` (string; one of text, user_email, user_phone_number)
- `buttons` (array of object; ≤ 3 items): Sent as a button template (text ≤640 chars)
  - `buttons[].type` (string; one of url, postback, phone)
  - `buttons[].title` (string; ≤ 20 characters)
  - `buttons[].url` (string (uri))
  - `buttons[].payload` (string)
  - `buttons[].phone` (string)
- `elements` (array of object; ≤ 10 items): Generic template (carousel)
  - `elements[].title` (string; ≤ 80 characters)
  - `elements[].subtitle` (string; ≤ 80 characters)
  - `elements[].imageUrl` (string (uri))
  - `elements[].url` (string (uri))
  - `elements[].buttons` (array of object; ≤ 3 items)
- `imageAspectRatio` (string; one of horizontal, square)
- `template` (object): Raw template payload (template_type …)
- `replyTo` (string): mid of the message to reply to
- `messagingType` (string; one of RESPONSE, UPDATE, MESSAGE_TAG)
- `tag` (string; one of HUMAN_AGENT): Human replies 24 h-7 d after the last user message (Human Agent feature)
- `personaId` (string)
- `notificationType` (string; one of REGULAR, SILENT_PUSH, NO_PUSH)
- `recipientId` (string): PSID (defaults to the conversation customer)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-conversations-typing`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `recipientId` (string; required)
- `on` (boolean)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-conversations-mark-seen`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `recipientId` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-conversations-react`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `recipientId` (string; required)
- `messageId` (string; required)
- `emoji` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-conversations-unreact`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `recipientId` (string; required)
- `messageId` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-conversations-accept`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `recipientId` (string; required)
- `message` (string; required; ≤ 2000 characters)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-conversations-thread-control`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `recipientId` (string; required)
- `action` (string; required; one of pass, take, request, release)
- `targetAppId` (string)
- `metadata` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-conversations-thread-owner`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `recipientId` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-conversations-profile`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `recipientId` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-conversations-upload-attachment`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `type` (string; one of image, video, audio, file)
- `url` (string (uri); required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-handover-apps-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/handover-apps" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `facebook-messenger-greeting-get` · Zernio: `GET /v1/accounts/{accountId}/messenger-greeting`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-greeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "data": [
    {
      "locale": "default",
      "text": "string"
    }
  ]
}
```

## 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: `write` · MCP tool: `facebook-messenger-greeting-update` · Zernio: `PUT /v1/accounts/{accountId}/messenger-greeting`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `greeting` (array of object; required; ≥ 1 items)
  - `greeting[].locale` (string)
  - `greeting[].text` (string; ≤ 160 characters): Supports {{user_first_name}}, {{user_last_name}}, {{user_full_name}}

```bash
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:

```json
{
  "data": [
    {
      "locale": "default",
      "text": "string"
    }
  ]
}
```

## 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: `write` · MCP tool: `facebook-messenger-greeting-delete` · Zernio: `DELETE /v1/accounts/{accountId}/messenger-greeting`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-greeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-messenger-get-started-get` · Zernio: `GET /v1/accounts/{accountId}/messenger-get-started`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-get-started" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "data": {
    "payload": "string"
  }
}
```

## 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: `write` · MCP tool: `facebook-messenger-get-started-update` · Zernio: `PUT /v1/accounts/{accountId}/messenger-get-started`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `payload` (string; required; ≤ 1000 characters)

```bash
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:

```json
{
  "data": {
    "payload": "string"
  }
}
```

## 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: `write` · MCP tool: `facebook-messenger-get-started-delete` · Zernio: `DELETE /v1/accounts/{accountId}/messenger-get-started`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-get-started" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-messenger-ice-breakers-get` · Zernio: `GET /v1/accounts/{accountId}/messenger-ice-breakers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "data": [
    {
      "locale": "default",
      "call_to_actions": [
        {
          "question": "string",
          "payload": "string"
        }
      ]
    }
  ]
}
```

## 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: `write` · MCP tool: `facebook-messenger-ice-breakers-update` · Zernio: `PUT /v1/accounts/{accountId}/messenger-ice-breakers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `ice_breakers` (array of object; required; ≥ 1 items)
  - `ice_breakers[].locale` (string)
  - `ice_breakers[].call_to_actions` (array of object; 1–4 items)
    - `ice_breakers[].call_to_actions[].question` (string; ≤ 80 characters)
    - `ice_breakers[].call_to_actions[].payload` (string)

```bash
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:

```json
{
  "data": [
    {
      "locale": "default",
      "call_to_actions": [
        {
          "question": "string",
          "payload": "string"
        }
      ]
    }
  ]
}
```

## 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: `write` · MCP tool: `facebook-messenger-ice-breakers-delete` · Zernio: `DELETE /v1/accounts/{accountId}/messenger-ice-breakers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-messenger-menu-get` · Zernio: `GET /v1/accounts/{accountId}/messenger-menu`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "data": [
    {
      "locale": "default",
      "composer_input_disabled": false,
      "call_to_actions": [
        {
          "type": "postback",
          "title": "string",
          "payload": "string",
          "url": "https://example.com",
          "webview_height_ratio": "compact",
          "call_to_actions": []
        }
      ]
    }
  ]
}
```

## 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: `write` · MCP tool: `facebook-messenger-menu-update` · Zernio: `PUT /v1/accounts/{accountId}/messenger-menu`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `persistent_menu` (array of object; required; ≥ 1 items)
  - `persistent_menu[].locale` (string)
  - `persistent_menu[].composer_input_disabled` (boolean)
  - `persistent_menu[].call_to_actions` (array of object; 1–20 items)
    - `persistent_menu[].call_to_actions[].type` (string; one of postback, web_url, nested)
    - `persistent_menu[].call_to_actions[].title` (string; ≤ 30 characters)
    - `persistent_menu[].call_to_actions[].payload` (string)
    - `persistent_menu[].call_to_actions[].url` (string (uri))
    - `persistent_menu[].call_to_actions[].webview_height_ratio` (string; one of compact, tall, full)
    - `persistent_menu[].call_to_actions[].call_to_actions` (array of object): Nested items (legacy)

```bash
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:

```json
{
  "data": [
    {
      "locale": "default",
      "composer_input_disabled": false,
      "call_to_actions": [
        {
          "type": "postback",
          "title": "string",
          "payload": "string",
          "url": "https://example.com",
          "webview_height_ratio": "compact",
          "call_to_actions": []
        }
      ]
    }
  ]
}
```

## 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: `write` · MCP tool: `facebook-messenger-menu-delete` · Zernio: `DELETE /v1/accounts/{accountId}/messenger-menu`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `facebook-messenger-domains-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-domains" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "data": [
    "https://example.com"
  ]
}
```

## 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` · MCP tool: `facebook-messenger-domains-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `whitelisted_domains` (array of string (uri); required; ≤ 50 items)

```bash
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:

```json
{
  "data": [
    "https://example.com"
  ]
}
```

## 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` · MCP tool: `facebook-messenger-domains-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/messenger-domains" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `facebook-personas-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/personas" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "profile_picture_url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-personas-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `name` (string; required)
- `profilePictureUrl` (string (uri); required)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "profile_picture_url": "https://example.com"
}
```

## 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` · MCP tool: `facebook-personas-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/personas/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "profile_picture_url": "https://example.com"
}
```

## 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` · MCP tool: `facebook-personas-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/personas/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `facebook-labels-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/labels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "page_label_name": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-labels-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `page_label_name` (string; required)

```bash
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:

```json
{
  "id": "string",
  "page_label_name": "string"
}
```

## 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` · MCP tool: `facebook-labels-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/labels/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-labels-assign`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `psid` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-labels-unassign`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `psid` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-message-templates-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/message-templates" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "language": "en_US",
      "category": "UTILITY",
      "status": "string",
      "components": [
        {}
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-message-templates-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `name` (string; required)
- `language` (string)
- `category` (string; one of UTILITY)
- `components` (array of object; required; ≥ 1 items)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "language": "en_US",
  "category": "UTILITY",
  "status": "string",
  "components": [
    {}
  ]
}
```

## 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` · MCP tool: `facebook-message-templates-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/message-templates/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-page-insights-list` · Zernio: `GET /v1/analytics/facebook/page-insights`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 30 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "impressions": 1.5,
      "reach": 1.5,
      "engagements": 1.5,
      "profile_views": 1.5,
      "followers": 1.5,
      "follower_change": 1.5,
      "views": 1.5,
      "watch_time_seconds": 1.5,
      "clicks": 1.5,
      "likes": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-page-insights-raw`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `since` (string (date)): YYYY-MM-DD (default: 30 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)
- `metrics` (array 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
- `metricType` (string; one of time_series, total_value)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-post-insights-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/post-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "message": "string",
      "created_time": "2026-10-13T09:00:00.000Z",
      "impressions": 1.5,
      "reach": 1.5,
      "likes": 1.5,
      "comments": 1.5,
      "shares": 1.5,
      "clicks": 1.5,
      "views": 1.5,
      "engagements": 1.5,
      "engagement_rate": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `facebook-post-insights-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/post-insights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "message": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "impressions": 1.5,
  "reach": 1.5,
  "likes": 1.5,
  "comments": 1.5,
  "shares": 1.5,
  "clicks": 1.5,
  "views": 1.5,
  "engagements": 1.5,
  "engagement_rate": 1.5
}
```

## 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` · MCP tool: `facebook-video-insights-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 30 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/video-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "page_video_views": 1.5,
      "page_video_views_paid": 1.5,
      "page_video_views_organic": 1.5,
      "page_video_views_autoplayed": 1.5,
      "page_video_views_click_to_play": 1.5,
      "page_video_repeat_views": 1.5,
      "page_video_complete_views_30s": 1.5,
      "page_video_view_time": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `facebook-video-insights-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Query parameters

- `reel` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/video-insights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "date": "2026-10-13",
  "page_video_views": 1.5,
  "page_video_views_paid": 1.5,
  "page_video_views_organic": 1.5,
  "page_video_views_autoplayed": 1.5,
  "page_video_views_click_to_play": 1.5,
  "page_video_repeat_views": 1.5,
  "page_video_complete_views_30s": 1.5,
  "page_video_view_time": 1.5
}
```

## 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` · MCP tool: `facebook-reaction-insights-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 30 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/reaction-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "LIKE": 1.5,
      "LOVE": 1.5,
      "WOW": 1.5,
      "HAHA": 1.5,
      "SAD": 1.5,
      "ANGRY": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `facebook-demographics-list` · Zernio: `GET /v1/analytics/facebook/demographics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `breakdown` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/demographics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "dimension": "country",
      "key": "string",
      "value": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `facebook-monetization-list` · Zernio: `GET /v1/analytics/facebook/post-earnings`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): YYYY-MM-DD (default: 30 days ago)
- `until` (string (date)): YYYY-MM-DD (default: today)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/monetization" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "date": "2026-10-13",
      "content_monetization_earnings": 1.5,
      "monetization_approximate_earnings": 1.5,
      "creator_monetization_qualified_views": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `facebook-monetization-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Query parameters

- `metrics` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/monetization/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "date": "2026-10-13",
  "content_monetization_earnings": 1.5,
  "monetization_approximate_earnings": 1.5,
  "creator_monetization_qualified_views": 1.5
}
```

## 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` · MCP tool: `facebook-page-profile-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "username": "string",
  "about": "string",
  "description": "string",
  "category": "string",
  "category_list": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "phone": "+15551234567",
  "emails": [
    "you@example.com"
  ],
  "website": "https://example.com",
  "hours": {
    "key": "string"
  },
  "is_always_open": true,
  "temporary_status": "differently_open",
  "location": {
    "street": "string",
    "city": "string",
    "state": "string",
    "zip": "string",
    "country": "US",
    "latitude": 1.5,
    "longitude": 1.5
  },
  "single_line_address": "string",
  "price_range": "$",
  "picture_url": "https://example.com",
  "cover_url": "https://example.com",
  "followers_count": 1,
  "fan_count": 1,
  "link": "https://example.com",
  "verification_status": "string"
}
```

## 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` · MCP tool: `facebook-page-profile-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `about` (string; ≤ 255 characters)
- `description` (string)
- `phone` (string)
- `emails` (array of string (email))
- `website` (string (uri))
- `hours` (object): Keys like mon_1_open / mon_1_close … sun_2_close, values HH:MM
- `isAlwaysOpen` (boolean)
- `temporaryStatus` (string; one of differently_open, temporarily_closed, operating_as_usual, no_data)
- `location` (object)
- `priceRange` (string)
- `categoryList` (array of string; ≤ 3 items)
- `impressum` (string)
- `mission` (string)
- `companyOverview` (string)
- `generalInfo` (string)
- `isPermanentlyClosed` (boolean)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "username": "string",
  "about": "string",
  "description": "string",
  "category": "string",
  "category_list": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "phone": "+15551234567",
  "emails": [
    "you@example.com"
  ],
  "website": "https://example.com",
  "hours": {
    "key": "string"
  },
  "is_always_open": true,
  "temporary_status": "differently_open",
  "location": {
    "street": "string",
    "city": "string",
    "state": "string",
    "zip": "string",
    "country": "US",
    "latitude": 1.5,
    "longitude": 1.5
  },
  "single_line_address": "string",
  "price_range": "$",
  "picture_url": "https://example.com",
  "cover_url": "https://example.com",
  "followers_count": 1,
  "fan_count": 1,
  "link": "https://example.com",
  "verification_status": "string"
}
```

## 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: `write` · MCP tool: `facebook-page-profile-set-cover`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `mediaId` (string)
- `url` (string (uri))
- `photoId` (string)
- `offsetY` (integer; 0–100)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `facebook-page-profile-set-picture`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `mediaId` (string)
- `url` (string (uri))
- `photoId` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-page-settings-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-settings" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "setting": "string",
      "value": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `facebook-page-settings-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `value` (any; required)

```bash
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:

```json
{
  "setting": "string",
  "value": "string"
}
```

## 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` · MCP tool: `facebook-call-to-action-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/call-to-action" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "type": "BOOK_NOW",
      "status": "string",
      "web_url": "https://example.com",
      "email_address": "you@example.com",
      "intl_number_with_plus": "string",
      "created_time": "2026-10-13T09:00:00.000Z",
      "updated_time": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `facebook-call-to-action-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `type` (string; one of BOOK_NOW, CALL_NOW, CONTACT_US, MESSAGE, SHOP_NOW, SIGN_UP, LEARN_MORE, ORDER_FOOD, VIEW_MENU, EMAIL, GET_DIRECTIONS, WATCH_VIDEO, …)
- `webUrl` (string (uri))
- `emailAddress` (string)
- `phone` (string)

```bash
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:

```json
{
  "id": "string",
  "type": "BOOK_NOW",
  "status": "string",
  "web_url": "https://example.com",
  "email_address": "you@example.com",
  "intl_number_with_plus": "string",
  "created_time": "2026-10-13T09:00:00.000Z",
  "updated_time": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `facebook-call-to-action-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
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:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-webhook-subscription-get` · Zernio: `GET /v1/accounts/{accountId}/webhook-subscription`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/webhook-subscription" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "pageId": "string",
  "appSubscribed": true,
  "subscribedFields": [
    "string"
  ],
  "missingFields": [
    "string"
  ],
  "warning": "string"
}
```

## 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: `write` · MCP tool: `facebook-webhook-subscription-subscribe` · Zernio: `POST /v1/accounts/{accountId}/webhook-subscription`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `scopeSet` (string; one of core, focus)
- `fields` (array of string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-webhook-subscription-unsubscribe`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `facebook-locations-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Opaque cursor from next_cursor
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "location": {},
      "link": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `read` · MCP tool: `facebook-pages-list` · Zernio: `GET /v1/accounts/{accountId}/facebook-page`, `GET /v1/connect/facebook/select-page`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/pages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "username": "string",
      "category": "string",
      "picture": "https://example.com",
      "tasks": [
        "MANAGE"
      ],
      "can_publish": true,
      "can_message": true,
      "can_analyze": true,
      "selected": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-pages-select` · Zernio: `PUT /v1/accounts/{accountId}/facebook-page`, `POST /v1/connect/facebook/select-page`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `facebook-business-partners-list` · Zernio: `GET /v1/accounts/{accountId}/business-partners`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/business-partners" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "permittedTasks": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-business-partners-create` · Zernio: `POST /v1/accounts/{accountId}/business-partners`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `businessId` (string; required; pattern ^\d+$)
- `permittedTasks` (array of string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "permittedTasks": [
    "string"
  ]
}
```

## 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: `write` · MCP tool: `facebook-business-partners-delete` · Zernio: `DELETE /v1/accounts/{accountId}/business-partners`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/business-partners/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `facebook-page-roles-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `businessId` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-roles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "tasks": [
        "MANAGE"
      ],
      "user_type": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `facebook-page-roles-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `userId` (string; required)
- `tasks` (array of string; required; ≥ 1 items)
- `businessId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "tasks": [
    "MANAGE"
  ],
  "user_type": "string"
}
```

## 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` · MCP tool: `facebook-page-roles-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `tasks` (array of string; required; ≥ 1 items)
- `businessId` (string)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "tasks": [
    "MANAGE"
  ],
  "user_type": "string"
}
```

## 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` · MCP tool: `facebook-page-roles-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/facebook/page-roles/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```


---

Source: https://socialit.com/docs/api-reference/focus-facebook-page/
