# Focus · Instagram API

> Typed Focus mode operations for Instagram accounts, generated from the Instagram 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>`.

## Instagram: Create a Stories item

`POST /accounts/{accountId}/instagram/stories`

Publish Story/Stories (each media item becomes one Story). Active Stories (24 h). Insights are only readable while live; archived story metrics come from the story_insights webhook (Facebook Login). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/stories Generic route: /v1/accounts/{accountId}/focus/stories.

Access: `write` · MCP tool: `instagram-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; 1–10 items)
  - `media[].media_id` (string | null)
  - `media[].url` (string (uri) | null)
  - `media[].type` (string | null; one of image, video)
  - `media[].alt_text` (string | null; ≤ 1000 characters)
- `user_tags` (array of object | null)
  - `user_tags[].username` (string)
  - `user_tags[].x` (number | null)
  - `user_tags[].y` (number | null)
  - `user_tags[].media_index` (integer | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/stories" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": [
      {
        "media_id": "string",
        "url": "https://example.com"
      }
    ],
    "user_tags": [
      {
        "username": "string",
        "x": 1.5
      }
    ]
  }'
```

Response 201:

```json
{
  "id": "string",
  "media_type": "IMAGE",
  "media_product_type": "STORY",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "username": "string"
}
```

## Instagram: Get Profile

`GET /accounts/{accountId}/instagram/profile`

Bio, website and counts. The Instagram API cannot edit the profile (bio, name, website, picture): use the Instagram app. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user Generic route: /v1/accounts/{accountId}/focus/profile.

Access: `read` · MCP tool: `instagram-profile-get`

### Path parameters

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

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

Response 200:

```json
{
  "id": "string",
  "username": "string",
  "name": "string",
  "biography": "string",
  "website": "https://example.com",
  "profile_picture_url": "https://example.com",
  "followers_count": 1,
  "follows_count": 1,
  "media_count": 1,
  "account_type": "BUSINESS",
  "login_type": "instagram_login",
  "page_id": "string",
  "shopping_product_tag_eligibility": true,
  "profile_url": "https://example.com",
  "editable": true
}
```

## Instagram: List Webhook subscriptions

`GET /accounts/{accountId}/instagram/webhook-subscriptions`

Real-time delivery of comments, mentions, DMs and story insights for this account. Cursor pagination: pass next_cursor back as cursor. Requires one of: instagram_business_basic | pages_manage_metadata. Network docs: https://developers.facebook.com/documentation/instagram-platform/webhooks Generic route: /v1/accounts/{accountId}/focus/webhook-subscriptions.

Access: `read` · MCP tool: `instagram-webhook-subscriptions-list`

### Path parameters

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

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

Response 200:

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

## Instagram: Create a Webhook subscriptions item

`POST /accounts/{accountId}/instagram/webhook-subscriptions`

Real-time delivery of comments, mentions, DMs and story insights for this account. Requires one of: instagram_business_basic | pages_manage_metadata. Network docs: https://developers.facebook.com/documentation/instagram-platform/webhooks Generic route: /v1/accounts/{accountId}/focus/webhook-subscriptions.

Access: `write` · MCP tool: `instagram-webhook-subscriptions-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

- `fields` (array of string | null): Defaults to every supported field

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/webhook-subscriptions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": [
      "string"
    ]
  }'
```

Response 201:

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

## Instagram: Unsubscribe (Webhook subscriptions)

`POST /accounts/{accountId}/instagram/webhook-subscriptions/unsubscribe`

Unsubscribe. Real-time delivery of comments, mentions, DMs and story insights for this account. Destructive. Requires one of: instagram_business_basic | pages_manage_metadata. Network docs: https://developers.facebook.com/documentation/instagram-platform/webhooks Generic route: /v1/accounts/{accountId}/focus/webhook-subscriptions.

Access: `write` · MCP tool: `instagram-webhook-subscriptions-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/instagram/webhook-subscriptions/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
}
```

## Instagram: List Posts

`GET /accounts/{accountId}/instagram/media`

Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Cursor pagination: pass next_cursor back as cursor. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `read` · MCP tool: `instagram-media-list` · Zernio: `GET /v1/accounts/{accountId}/posts`

### Path parameters

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

### Query parameters

- `limit` (integer; 1–100)
- `after` (string): Cursor from next_cursor
- `since` (string (date-time) | null)
- `until` (string (date-time) | null)
- `media_type` (string | null; one of IMAGE, VIDEO, CAROUSEL_ALBUM)
- `product_type` (string | null; one of FEED, REELS)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "caption": "string",
      "media_type": "IMAGE",
      "media_product_type": "FEED",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "https://example.com",
      "shortcode": "string",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "username": "string",
      "like_count": 1,
      "comments_count": 1,
      "is_comment_enabled": true,
      "is_shared_to_feed": true,
      "alt_text": "string",
      "children": [
        {
          "id": "string",
          "media_type": "IMAGE",
          "media_url": "https://example.com",
          "thumbnail_url": "https://example.com"
        }
      ],
      "reposts_count": 1,
      "saved_count": 1,
      "shares_count": 1,
      "media_audio_type": "MUSIC",
      "is_ai_generated": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Instagram: Create a Posts item

`POST /accounts/{accountId}/instagram/media`

Publish now (feed image, Reel, carousel or Story). Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-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

- `caption` (string | null; ≤ 2200 characters): ≤2,200 chars, ≤30 hashtags, ≤20 @mentions. Ignored for Stories.
- `media` (array of object; required; 1–10 items)
  - `media[].media_id` (string | null)
  - `media[].url` (string (uri) | null)
  - `media[].type` (string | null; one of image, video)
  - `media[].alt_text` (string | null; ≤ 1000 characters)
- `options` (object)
  - `options.contentType` (string; one of auto, feed, reel, story, carousel): auto: 1 image → feed, 1 video → Reel, 2–10 items → carousel. story publishes each media item as a Story. Every single video is a Reel (use shareToFeed for a feed video).
  - `options.shareToFeed` (boolean): Reels only: also show the Reel in the main feed.
  - `options.collaborators` (array of string; ≤ 3 items): Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).
  - `options.userTags` (array of string | object; ≤ 20 items): People tags (feed, Reels, carousel items, Stories).
    - one of: Option 1 (string)
    - one of: Option 2 (object)
      - `options.userTags.username` (string; required)
      - `options.userTags.x` (number; 0–1): From the left edge. Required for photos (defaults to 0.5), ignored for video.
      - `options.userTags.y` (number; 0–1): From the top edge. Required for photos (defaults to 0.5), ignored for video.
      - `options.userTags.mediaIndex` (integer): Carousel slide index.
  - `options.locationId` (string; pattern ^[0-9]+$): Facebook Page id with location data (feed, Reels, carousels; not Stories).
  - `options.altText` (string; ≤ 1000 characters): Fallback alt text for images (per-item media[].altText wins). Images only.
  - `options.coverUrl` (string (uri)): Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl.
  - `options.thumbOffset` (integer): Reel cover frame offset in milliseconds.
  - `options.audioName` (string): Rename the Reel original audio (once, at creation).
  - `options.audioConfiguration` (object): Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).
    - `options.audioConfiguration.audioId` (string; required)
    - `options.audioConfiguration.audioVolume` (integer; 0–100)
    - `options.audioConfiguration.videoVolume` (integer; 0–100): 0 mutes the original sound.
  - `options.muteAudio` (boolean): Silence the original sound. With audioConfiguration this sets video_volume=0; otherwise the media pipeline must strip the audio track before publishing (the Graph API has no mute flag).
  - `options.trialParams` (object): Trial Reel shown to non-followers first (Reels only).
    - `options.trialParams.graduationStrategy` (string; required; one of MANUAL, SS_PERFORMANCE)
  - `options.isAiGenerated` (boolean): Meta "AI info" label (carousel: parent only).
  - `options.isPaidPartnership` (boolean): "Paid partnership" label (Facebook Login only; not Stories).
  - `options.brandedContentSponsors` (array of string; ≤ 2 items): Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.
  - `options.productTags` (array of object): Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.
    - `options.productTags[].productId` (string; required)
    - `options.productTags[].x` (number; 0–1)
    - `options.productTags[].y` (number; 0–1)
    - `options.productTags[].mediaIndex` (integer)
  - `options.commentsEnabled` (boolean): false disables comments right after publishing (best-effort; not Stories).
  - `options.firstComment` (string; ≤ 2200 characters): Posted as the first comment (not Stories). Also read from post.firstComment.
  - `options.uploadType` (string; one of url, resumable): resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url.
  - `options.checkPublishingLimit` (boolean): Read content_publishing_limit first and fail fast when the 24 h quota is used up.
  - `options.containerId` (string): Publish a container created earlier (≤24 h) instead of creating a new one.
- `first_comment` (string | null; ≤ 2200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "string",
    "media": [
      {
        "media_id": "string",
        "url": "https://example.com"
      }
    ],
    "options": {
      "contentType": "auto",
      "shareToFeed": true
    },
    "first_comment": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "caption": "string",
  "media_type": "IMAGE",
  "media_product_type": "FEED",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "shortcode": "string",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "username": "string",
  "like_count": 1,
  "comments_count": 1,
  "is_comment_enabled": true,
  "is_shared_to_feed": true,
  "alt_text": "string",
  "children": [
    {
      "id": "string",
      "media_type": "IMAGE",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com"
    }
  ],
  "reposts_count": 1,
  "saved_count": 1,
  "shares_count": 1,
  "media_audio_type": "MUSIC",
  "is_ai_generated": true
}
```

## Instagram: Get a Posts item

`GET /accounts/{accountId}/instagram/media/{itemId}`

Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `read` · MCP tool: `instagram-media-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/instagram/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "caption": "string",
  "media_type": "IMAGE",
  "media_product_type": "FEED",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "shortcode": "string",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "username": "string",
  "like_count": 1,
  "comments_count": 1,
  "is_comment_enabled": true,
  "is_shared_to_feed": true,
  "alt_text": "string",
  "children": [
    {
      "id": "string",
      "media_type": "IMAGE",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com"
    }
  ],
  "reposts_count": 1,
  "saved_count": 1,
  "shares_count": 1,
  "media_audio_type": "MUSIC",
  "is_ai_generated": true
}
```

## Instagram: Update a Posts item

`PATCH /accounts/{accountId}/instagram/media/{itemId}`

Only comments_enabled can change after publishing (no caption edit). Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-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

- `comments_enabled` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "comments_enabled": true
  }'
```

Response 200:

```json
{
  "id": "string",
  "caption": "string",
  "media_type": "IMAGE",
  "media_product_type": "FEED",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "shortcode": "string",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "username": "string",
  "like_count": 1,
  "comments_count": 1,
  "is_comment_enabled": true,
  "is_shared_to_feed": true,
  "alt_text": "string",
  "children": [
    {
      "id": "string",
      "media_type": "IMAGE",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com"
    }
  ],
  "reposts_count": 1,
  "saved_count": 1,
  "shares_count": 1,
  "media_audio_type": "MUSIC",
  "is_ai_generated": true
}
```

## Instagram: Delete a Posts item

`DELETE /accounts/{accountId}/instagram/media/{itemId}`

Delete post/Reel/carousel/Story (Facebook Login + instagram_manage_contents). Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires scopes: instagram_basic, instagram_manage_contents. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-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/instagram/media/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

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

## Instagram: Enable comments (Posts)

`POST /accounts/{accountId}/instagram/media/{itemId}/enable-comments`

Enable comments. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-enable-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.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/media/ITEM_ID/enable-comments" \
  -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
}
```

## Instagram: Disable comments (Posts)

`POST /accounts/{accountId}/instagram/media/{itemId}/disable-comments`

Disable comments. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-disable-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.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/media/ITEM_ID/disable-comments" \
  -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
}
```

## Instagram: Add comment (Posts)

`POST /accounts/{accountId}/instagram/media/{itemId}/comment`

Add comment. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-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; ≤ 2200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/media/ITEM_ID/comment" \
  -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
}
```

## Instagram: Insights (Posts)

`POST /accounts/{accountId}/instagram/media/{itemId}/insights`

Per-type metrics (views, reach, likes, comments, saves, shares, watch time, skip rate, navigation…). Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-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/instagram/media/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
}
```

## Instagram: Carousel items (Posts)

`POST /accounts/{accountId}/instagram/media/{itemId}/children`

Carousel items. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-children`

### 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/instagram/media/ITEM_ID/children" \
  -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
}
```

## Instagram: Collaborators (Posts)

`POST /accounts/{accountId}/instagram/media/{itemId}/collaborators`

Collaborators. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires scopes: instagram_basic. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-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/instagram/media/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
}
```

## Instagram: Like as business (Posts)

`POST /accounts/{accountId}/instagram/media/{itemId}/like`

Like as business. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-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/instagram/media/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
}
```

## Instagram: Unlike (Posts)

`POST /accounts/{accountId}/instagram/media/{itemId}/unlike`

Unlike. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: /v1/accounts/{accountId}/focus/media.

Access: `write` · MCP tool: `instagram-media-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/instagram/media/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
}
```

## Instagram: List Reels

`GET /accounts/{accountId}/instagram/reels`

Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Cursor pagination: pass next_cursor back as cursor. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `read` · MCP tool: `instagram-reels-list`

### Path parameters

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

### Query parameters

- `limit` (integer; 1–100)
- `after` (string): Cursor from next_cursor

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "caption": "string",
      "media_type": "IMAGE",
      "media_product_type": "FEED",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "https://example.com",
      "shortcode": "string",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "username": "string",
      "like_count": 1,
      "comments_count": 1,
      "is_comment_enabled": true,
      "is_shared_to_feed": true,
      "alt_text": "string",
      "children": [
        {
          "id": "string",
          "media_type": "IMAGE",
          "media_url": "https://example.com",
          "thumbnail_url": "https://example.com"
        }
      ],
      "reposts_count": 1,
      "saved_count": 1,
      "shares_count": 1,
      "media_audio_type": "MUSIC",
      "is_ai_generated": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Instagram: Create a Reels item

`POST /accounts/{accountId}/instagram/reels`

Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `write` · MCP tool: `instagram-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

- `caption` (string | null; ≤ 2200 characters)
- `video` (object; required)
  - `video.media_id` (string | null)
  - `video.url` (string (uri) | null)
- `share_to_feed` (boolean | null)
- `cover_url` (string (uri) | null)
- `thumb_offset` (integer | null)
- `audio_name` (string | null)
- `audio_id` (string | null): Audio API track (Facebook Login)
- `trial` (string | null; one of MANUAL, SS_PERFORMANCE): Publish as a trial Reel
- `collaborators` (array of string | null; ≤ 3 items)
- `location_id` (string | null)
- `first_comment` (string | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/reels" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "string",
    "video": {
      "media_id": "string",
      "url": "https://example.com"
    },
    "share_to_feed": true,
    "cover_url": "https://example.com",
    "thumb_offset": 0
  }'
```

Response 201:

```json
{
  "id": "string",
  "caption": "string",
  "media_type": "IMAGE",
  "media_product_type": "FEED",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "shortcode": "string",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "username": "string",
  "like_count": 1,
  "comments_count": 1,
  "is_comment_enabled": true,
  "is_shared_to_feed": true,
  "alt_text": "string",
  "children": [
    {
      "id": "string",
      "media_type": "IMAGE",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com"
    }
  ],
  "reposts_count": 1,
  "saved_count": 1,
  "shares_count": 1,
  "media_audio_type": "MUSIC",
  "is_ai_generated": true
}
```

## Instagram: Get a Reels item

`GET /accounts/{accountId}/instagram/reels/{itemId}`

Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `read` · MCP tool: `instagram-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/instagram/reels/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "caption": "string",
  "media_type": "IMAGE",
  "media_product_type": "FEED",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "shortcode": "string",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "username": "string",
  "like_count": 1,
  "comments_count": 1,
  "is_comment_enabled": true,
  "is_shared_to_feed": true,
  "alt_text": "string",
  "children": [
    {
      "id": "string",
      "media_type": "IMAGE",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com"
    }
  ],
  "reposts_count": 1,
  "saved_count": 1,
  "shares_count": 1,
  "media_audio_type": "MUSIC",
  "is_ai_generated": true
}
```

## Instagram: Delete a Reels item

`DELETE /accounts/{accountId}/instagram/reels/{itemId}`

Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires scopes: instagram_basic, instagram_manage_contents. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `write` · MCP tool: `instagram-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/instagram/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
}
```

## Instagram: Enable comments (Reels)

`POST /accounts/{accountId}/instagram/reels/{itemId}/enable-comments`

Enable comments. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `write` · MCP tool: `instagram-reels-enable-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.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/reels/ITEM_ID/enable-comments" \
  -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
}
```

## Instagram: Disable comments (Reels)

`POST /accounts/{accountId}/instagram/reels/{itemId}/disable-comments`

Disable comments. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `write` · MCP tool: `instagram-reels-disable-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.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/reels/ITEM_ID/disable-comments" \
  -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
}
```

## Instagram: Add comment (Reels)

`POST /accounts/{accountId}/instagram/reels/{itemId}/comment`

Add comment. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `write` · MCP tool: `instagram-reels-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; ≤ 2200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/reels/ITEM_ID/comment" \
  -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
}
```

## Instagram: Insights (Reels)

`POST /accounts/{accountId}/instagram/reels/{itemId}/insights`

Per-type metrics (views, reach, likes, comments, saves, shares, watch time, skip rate, navigation…). Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `write` · MCP tool: `instagram-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/instagram/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
}
```

## Instagram: Carousel items (Reels)

`POST /accounts/{accountId}/instagram/reels/{itemId}/children`

Carousel items. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `write` · MCP tool: `instagram-reels-children`

### 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/instagram/reels/ITEM_ID/children" \
  -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
}
```

## Instagram: Collaborators (Reels)

`POST /accounts/{accountId}/instagram/reels/{itemId}/collaborators`

Collaborators. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires scopes: instagram_basic. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `write` · MCP tool: `instagram-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/instagram/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
}
```

## Instagram: Like as business (Reels)

`POST /accounts/{accountId}/instagram/reels/{itemId}/like`

Like as business. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `write` · MCP tool: `instagram-reels-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/instagram/reels/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
}
```

## Instagram: Unlike (Reels)

`POST /accounts/{accountId}/instagram/reels/{itemId}/unlike`

Unlike. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/reels.

Access: `write` · MCP tool: `instagram-reels-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/instagram/reels/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
}
```

## Instagram: Delete a Stories item

`DELETE /accounts/{accountId}/instagram/stories/{itemId}`

Active Stories (24 h). Insights are only readable while live; archived story metrics come from the story_insights webhook (Facebook Login). Requires scopes: instagram_basic, instagram_manage_contents. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/stories Generic route: /v1/accounts/{accountId}/focus/stories.

Access: `write` · MCP tool: `instagram-stories-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/instagram/stories/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

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

## Instagram: Story insights (Stories)

`POST /accounts/{accountId}/instagram/stories/{itemId}/insights`

views, reach, replies, shares, profile visits, follows, taps forward/back, exits, swipes. Active Stories (24 h). Insights are only readable while live; archived story metrics come from the story_insights webhook (Facebook Login). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/stories Generic route: /v1/accounts/{accountId}/focus/stories.

Access: `write` · MCP tool: `instagram-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/instagram/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
}
```

## Instagram: Get a Media containers item

`GET /accounts/{accountId}/instagram/containers/{itemId}`

Low-level two-step publishing: create a container (expires in 24 h), check its status, publish it. Requires one of: instagram_business_content_publish | instagram_content_publish. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/containers.

Access: `read` · MCP tool: `instagram-containers-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/instagram/containers/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "status_code": "IN_PROGRESS",
  "status": "string"
}
```

## Instagram: Create a Media containers item

`POST /accounts/{accountId}/instagram/containers`

Create a container with raw Graph params (image_url | video_url, media_type, caption, …). Low-level two-step publishing: create a container (expires in 24 h), check its status, publish it. Requires one of: instagram_business_content_publish | instagram_content_publish. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/containers.

Access: `write` · MCP tool: `instagram-containers-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

- `image_url` (string (uri) | null)
- `video_url` (string (uri) | null)
- `media_type` (string | null; one of REELS, STORIES, CAROUSEL, VIDEO)
- `caption` (string | null)
- `is_carousel_item` (boolean | null)
- `children` (array of string | null)
- `share_to_feed` (boolean | null)
- `cover_url` (string (uri) | null)
- `thumb_offset` (integer | null)
- `location_id` (string | null)
- `alt_text` (string | null)
- `collaborators` (array of string | null)
- `user_tags` (array of object | null)
  - `user_tags[].username` (string)
  - `user_tags[].x` (number | null)
  - `user_tags[].y` (number | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/containers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com",
    "video_url": "https://example.com",
    "media_type": "REELS",
    "caption": "string",
    "is_carousel_item": true
  }'
```

Response 201:

```json
{
  "id": "string",
  "status_code": "IN_PROGRESS",
  "status": "string"
}
```

## Instagram: Publish container (Media containers)

`POST /accounts/{accountId}/instagram/containers/{itemId}/publish`

Publish container. Low-level two-step publishing: create a container (expires in 24 h), check its status, publish it. Requires one of: instagram_business_content_publish | instagram_content_publish. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: /v1/accounts/{accountId}/focus/containers.

Access: `write` · MCP tool: `instagram-containers-publish`

### 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/instagram/containers/ITEM_ID/publish" \
  -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
}
```

## Instagram: List Scheduled & drafts

`GET /accounts/{accountId}/instagram/scheduled`

Posts scheduled or drafted in Socialit for this account. Requires the API to provide ctx.posts. Cursor pagination: pass next_cursor back as cursor. Requires one of: instagram_business_content_publish | instagram_content_publish. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `read` · MCP tool: `instagram-scheduled-list`

### Path parameters

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

### Query parameters

- `status` (string | null; one of draft, scheduled, failed)
- `from` (string (date-time) | null)
- `to` (string (date-time) | null)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "status": "draft",
      "content": "string",
      "scheduled_for": "2026-10-13T09:00:00.000Z",
      "media": [
        {
          "media_id": "string",
          "url": "https://example.com",
          "type": "image",
          "alt_text": "string"
        }
      ],
      "platform_options": {
        "contentType": "auto",
        "shareToFeed": true,
        "collaborators": [
          "string"
        ],
        "userTags": [
          null
        ],
        "locationId": "string",
        "altText": "string"
      }
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Instagram: Create a Scheduled & drafts item

`POST /accounts/{accountId}/instagram/scheduled`

Posts scheduled or drafted in Socialit for this account. Requires the API to provide ctx.posts. Requires one of: instagram_business_content_publish | instagram_content_publish. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `write` · MCP tool: `instagram-scheduled-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 | null)
- `scheduled_for` (string (date-time) | null)
- `status` (string | null; one of draft, scheduled)
- `media` (array of object | null; 1–10 items)
  - `media[].media_id` (string | null)
  - `media[].url` (string (uri) | null)
  - `media[].type` (string | null; one of image, video)
  - `media[].alt_text` (string | null; ≤ 1000 characters)
- `platform_options` (object | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/scheduled" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "scheduled_for": "2026-10-13T09:00:00.000Z",
    "status": "draft",
    "media": [
      {
        "media_id": "string",
        "url": "https://example.com"
      }
    ],
    "platform_options": {}
  }'
```

Response 201:

```json
{
  "id": "string",
  "status": "draft",
  "content": "string",
  "scheduled_for": "2026-10-13T09:00:00.000Z",
  "media": [
    {
      "media_id": "string",
      "url": "https://example.com",
      "type": "image",
      "alt_text": "string"
    }
  ],
  "platform_options": {
    "contentType": "auto",
    "shareToFeed": true,
    "collaborators": [
      "string"
    ],
    "userTags": [
      "string"
    ],
    "locationId": "string",
    "altText": "string",
    "coverUrl": "https://example.com",
    "thumbOffset": 0,
    "audioName": "string",
    "audioConfiguration": {
      "audioId": "string",
      "audioVolume": 100,
      "videoVolume": 100
    },
    "muteAudio": false,
    "trialParams": {
      "graduationStrategy": "MANUAL"
    },
    "isAiGenerated": false,
    "isPaidPartnership": false,
    "brandedContentSponsors": [
      "string"
    ],
    "productTags": [
      {
        "productId": "string"
      }
    ],
    "commentsEnabled": true,
    "firstComment": "string",
    "uploadType": "url",
    "checkPublishingLimit": false,
    "containerId": "string"
  }
}
```

## Instagram: Get a Scheduled & drafts item

`GET /accounts/{accountId}/instagram/scheduled/{itemId}`

Posts scheduled or drafted in Socialit for this account. Requires the API to provide ctx.posts. Requires one of: instagram_business_content_publish | instagram_content_publish. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `read` · MCP tool: `instagram-scheduled-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/instagram/scheduled/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "status": "draft",
  "content": "string",
  "scheduled_for": "2026-10-13T09:00:00.000Z",
  "media": [
    {
      "media_id": "string",
      "url": "https://example.com",
      "type": "image",
      "alt_text": "string"
    }
  ],
  "platform_options": {
    "contentType": "auto",
    "shareToFeed": true,
    "collaborators": [
      "string"
    ],
    "userTags": [
      "string"
    ],
    "locationId": "string",
    "altText": "string",
    "coverUrl": "https://example.com",
    "thumbOffset": 0,
    "audioName": "string",
    "audioConfiguration": {
      "audioId": "string",
      "audioVolume": 100,
      "videoVolume": 100
    },
    "muteAudio": false,
    "trialParams": {
      "graduationStrategy": "MANUAL"
    },
    "isAiGenerated": false,
    "isPaidPartnership": false,
    "brandedContentSponsors": [
      "string"
    ],
    "productTags": [
      {
        "productId": "string"
      }
    ],
    "commentsEnabled": true,
    "firstComment": "string",
    "uploadType": "url",
    "checkPublishingLimit": false,
    "containerId": "string"
  }
}
```

## Instagram: Update a Scheduled & drafts item

`PATCH /accounts/{accountId}/instagram/scheduled/{itemId}`

Posts scheduled or drafted in Socialit for this account. Requires the API to provide ctx.posts. Requires one of: instagram_business_content_publish | instagram_content_publish. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `write` · MCP tool: `instagram-scheduled-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

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/scheduled/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "id": "string",
  "status": "draft",
  "content": "string",
  "scheduled_for": "2026-10-13T09:00:00.000Z",
  "media": [
    {
      "media_id": "string",
      "url": "https://example.com",
      "type": "image",
      "alt_text": "string"
    }
  ],
  "platform_options": {
    "contentType": "auto",
    "shareToFeed": true,
    "collaborators": [
      "string"
    ],
    "userTags": [
      "string"
    ],
    "locationId": "string",
    "altText": "string",
    "coverUrl": "https://example.com",
    "thumbOffset": 0,
    "audioName": "string",
    "audioConfiguration": {
      "audioId": "string",
      "audioVolume": 100,
      "videoVolume": 100
    },
    "muteAudio": false,
    "trialParams": {
      "graduationStrategy": "MANUAL"
    },
    "isAiGenerated": false,
    "isPaidPartnership": false,
    "brandedContentSponsors": [
      "string"
    ],
    "productTags": [
      {
        "productId": "string"
      }
    ],
    "commentsEnabled": true,
    "firstComment": "string",
    "uploadType": "url",
    "checkPublishingLimit": false,
    "containerId": "string"
  }
}
```

## Instagram: Delete a Scheduled & drafts item

`DELETE /accounts/{accountId}/instagram/scheduled/{itemId}`

Posts scheduled or drafted in Socialit for this account. Requires the API to provide ctx.posts. Requires one of: instagram_business_content_publish | instagram_content_publish. Generic route: /v1/accounts/{accountId}/focus/scheduled.

Access: `write` · MCP tool: `instagram-scheduled-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/instagram/scheduled/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

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

## Instagram: List Live

`GET /accounts/{accountId}/instagram/live`

Live broadcast in progress (read-only; starting a Live is not possible via API). Live comments arrive by webhook. Cursor pagination: pass next_cursor back as cursor. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/live_media Generic route: /v1/accounts/{accountId}/focus/live.

Access: `read` · MCP tool: `instagram-live-list`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "media_type": "string",
      "media_product_type": "string",
      "username": "string",
      "timestamp": "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"
}
```

## Instagram: List Collab invites

`GET /accounts/{accountId}/instagram/collaboration-invites`

Pending collaboration invitations (GET 300/24 h, accept/decline 50/24 h). Cursor pagination: pass next_cursor back as cursor. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/collaboration Generic route: /v1/accounts/{accountId}/focus/collaboration-invites.

Access: `read` · MCP tool: `instagram-collaboration-invites-list`

### Path parameters

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

### Query parameters

- `limit` (integer; 1–100)
- `after` (string): Cursor from next_cursor

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "media_id": "string",
      "media_owner_username": "string",
      "caption": "string",
      "media_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"
}
```

## Instagram: Accept (Collab invites)

`POST /accounts/{accountId}/instagram/collaboration-invites/{itemId}/accept`

Accept. Pending collaboration invitations (GET 300/24 h, accept/decline 50/24 h). Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/collaboration Generic route: /v1/accounts/{accountId}/focus/collaboration-invites.

Access: `write` · MCP tool: `instagram-collaboration-invites-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.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/collaboration-invites/ITEM_ID/accept" \
  -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
}
```

## Instagram: Decline (Collab invites)

`POST /accounts/{accountId}/instagram/collaboration-invites/{itemId}/decline`

Decline. Pending collaboration invitations (GET 300/24 h, accept/decline 50/24 h). Destructive. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/collaboration Generic route: /v1/accounts/{accountId}/focus/collaboration-invites.

Access: `write` · MCP tool: `instagram-collaboration-invites-decline`

### 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/instagram/collaboration-invites/ITEM_ID/decline" \
  -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
}
```

## Instagram: List Collab posts

`GET /accounts/{accountId}/instagram/collaborative-media`

Cursor pagination: pass next_cursor back as cursor. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/collaboration Generic route: /v1/accounts/{accountId}/focus/collaborative-media.

Access: `read` · MCP tool: `instagram-collaborative-media-list`

### Path parameters

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

### Query parameters

- `limit` (integer; 1–100)
- `after` (string): Cursor from next_cursor

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "caption": "string",
      "media_type": "IMAGE",
      "media_product_type": "FEED",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "https://example.com",
      "shortcode": "string",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "username": "string",
      "like_count": 1,
      "comments_count": 1,
      "is_comment_enabled": true,
      "is_shared_to_feed": true,
      "alt_text": "string",
      "children": [
        {
          "id": "string",
          "media_type": "IMAGE",
          "media_url": "https://example.com",
          "thumbnail_url": "https://example.com"
        }
      ],
      "reposts_count": 1,
      "saved_count": 1,
      "shares_count": 1,
      "media_audio_type": "MUSIC",
      "is_ai_generated": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Instagram: List Event reminders

`GET /accounts/{accountId}/instagram/upcoming-events`

Upcoming event reminders (business-linked accounts; only events created via API/Ads Manager are listed). Cursor pagination: pass next_cursor back as cursor. Requires scopes: instagram_basic, instagram_manage_upcoming_events. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/upcoming-events Generic route: /v1/accounts/{accountId}/focus/upcoming-events.

Access: `read` · MCP tool: `instagram-upcoming-events-list`

### Path parameters

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

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "start_time": "2026-10-13T09:00:00.000Z",
      "end_time": "2026-10-13T09:00:00.000Z",
      "notification_subtypes": [
        "BEFORE_EVENT_1DAY"
      ],
      "notification_target_time": "EVENT_START"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Instagram: Create a Event reminders item

`POST /accounts/{accountId}/instagram/upcoming-events`

Upcoming event reminders (business-linked accounts; only events created via API/Ads Manager are listed). Requires scopes: instagram_basic, instagram_manage_upcoming_events. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/upcoming-events Generic route: /v1/accounts/{accountId}/focus/upcoming-events.

Access: `write` · MCP tool: `instagram-upcoming-events-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)
- `start_time` (string (date-time))
- `end_time` (string (date-time) | null)
- `notification_subtypes` (array of string | null)
- `notification_target_time` (string | null; one of EVENT_START, EVENT_END)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/upcoming-events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "start_time": "2026-10-13T09:00:00.000Z",
    "end_time": "2026-10-13T09:00:00.000Z",
    "notification_subtypes": [
      "BEFORE_EVENT_1DAY"
    ],
    "notification_target_time": "EVENT_START"
  }'
```

Response 201:

```json
{
  "id": "string",
  "title": "string",
  "start_time": "2026-10-13T09:00:00.000Z",
  "end_time": "2026-10-13T09:00:00.000Z",
  "notification_subtypes": [
    "BEFORE_EVENT_1DAY"
  ],
  "notification_target_time": "EVENT_START"
}
```

## Instagram: Get a Event reminders item

`GET /accounts/{accountId}/instagram/upcoming-events/{itemId}`

Upcoming event reminders (business-linked accounts; only events created via API/Ads Manager are listed). Requires scopes: instagram_basic, instagram_manage_upcoming_events. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/upcoming-events Generic route: /v1/accounts/{accountId}/focus/upcoming-events.

Access: `read` · MCP tool: `instagram-upcoming-events-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/instagram/upcoming-events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "start_time": "2026-10-13T09:00:00.000Z",
  "end_time": "2026-10-13T09:00:00.000Z",
  "notification_subtypes": [
    "BEFORE_EVENT_1DAY"
  ],
  "notification_target_time": "EVENT_START"
}
```

## Instagram: Update a Event reminders item

`PATCH /accounts/{accountId}/instagram/upcoming-events/{itemId}`

Upcoming event reminders (business-linked accounts; only events created via API/Ads Manager are listed). Requires scopes: instagram_basic, instagram_manage_upcoming_events. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/upcoming-events Generic route: /v1/accounts/{accountId}/focus/upcoming-events.

Access: `write` · MCP tool: `instagram-upcoming-events-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)
- `start_time` (string (date-time))
- `end_time` (string (date-time) | null)
- `notification_subtypes` (array of string | null)
- `notification_target_time` (string | null; one of EVENT_START, EVENT_END)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/upcoming-events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "start_time": "2026-10-13T09:00:00.000Z",
    "end_time": "2026-10-13T09:00:00.000Z",
    "notification_subtypes": [
      "BEFORE_EVENT_1DAY"
    ],
    "notification_target_time": "EVENT_START"
  }'
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "start_time": "2026-10-13T09:00:00.000Z",
  "end_time": "2026-10-13T09:00:00.000Z",
  "notification_subtypes": [
    "BEFORE_EVENT_1DAY"
  ],
  "notification_target_time": "EVENT_START"
}
```

## Instagram: List Comments

`GET /accounts/{accountId}/instagram/comments`

Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Cursor pagination: pass next_cursor back as cursor. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `read` · MCP tool: `instagram-comments-list` · Zernio: `GET /v1/inbox/comments`

### Path parameters

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

### Query parameters

- `limit` (integer; 1–100)
- `after` (string): Cursor from next_cursor
- `media_id` (string | null): Only comments on this media
- `media_limit` (integer | null; 1–50): Recent media scanned for the queue

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/comments" \
  -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,
      "hidden": true,
      "parent_id": "string",
      "media_id": "string",
      "replies_count": 1,
      "replies": [
        {
          "id": "string",
          "text": "string",
          "author": "string",
          "created_at": "2026-10-13T09:00:00.000Z",
          "like_count": 1,
          "hidden": true
        }
      ],
      "media": {
        "id": "string",
        "caption": "string",
        "permalink": "https://example.com",
        "media_product_type": "FEED",
        "thumbnail_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"
}
```

## Instagram: Create a Comments item

`POST /accounts/{accountId}/instagram/comments`

Top-level comment on a media object. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `instagram-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

- `media_id` (string; required)
- `message` (string; required; ≤ 2200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media_id": "string",
    "message": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "author_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "hidden": true,
  "parent_id": "string",
  "media_id": "string",
  "replies_count": 1,
  "replies": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "hidden": true
    }
  ],
  "media": {
    "id": "string",
    "caption": "string",
    "permalink": "https://example.com",
    "media_product_type": "FEED",
    "thumbnail_url": "https://example.com"
  }
}
```

## Instagram: Get a Comments item

`GET /accounts/{accountId}/instagram/comments/{itemId}`

Comment with replies. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `read` · MCP tool: `instagram-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/instagram/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,
  "hidden": true,
  "parent_id": "string",
  "media_id": "string",
  "replies_count": 1,
  "replies": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "hidden": true
    }
  ],
  "media": {
    "id": "string",
    "caption": "string",
    "permalink": "https://example.com",
    "media_product_type": "FEED",
    "thumbnail_url": "https://example.com"
  }
}
```

## Instagram: Delete a Comments item

`DELETE /accounts/{accountId}/instagram/comments/{itemId}`

Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `instagram-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/instagram/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
}
```

## Instagram: Reply (Comments)

`POST /accounts/{accountId}/instagram/comments/{itemId}/reply`

Reply. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `instagram-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; ≤ 2200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/comments/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
}
```

## Instagram: Load replies (Comments)

`POST /accounts/{accountId}/instagram/comments/{itemId}/replies`

Load replies. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `instagram-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.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/comments/ITEM_ID/replies" \
  -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
}
```

## Instagram: Hide (Comments)

`POST /accounts/{accountId}/instagram/comments/{itemId}/hide`

Hide. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `instagram-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/instagram/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
}
```

## Instagram: Unhide (Comments)

`POST /accounts/{accountId}/instagram/comments/{itemId}/unhide`

Unhide. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `instagram-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/instagram/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
}
```

## Instagram: Like (Comments)

`POST /accounts/{accountId}/instagram/comments/{itemId}/like`

Like. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `instagram-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/instagram/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
}
```

## Instagram: Unlike (Comments)

`POST /accounts/{accountId}/instagram/comments/{itemId}/unlike`

Unlike. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `instagram-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/instagram/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
}
```

## Instagram: Reply privately (DM) (Comments)

`POST /accounts/{accountId}/instagram/comments/{itemId}/private-reply`

One DM per comment within 7 days; buttons may be refused for non-followers. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: /v1/accounts/{accountId}/focus/comments.

Access: `write` · MCP tool: `instagram-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

- `text` (string | null; ≤ 1000 characters): ≤1000 bytes; URLs must be valid
- `attachment` (object | null)
  - `attachment.type` (string; one of image, video, audio, file)
  - `attachment.url` (string (uri) | null)
  - `attachment.media_id` (string | null)
  - `attachment.attachment_id` (string | null): Reusable id from the Attachment Upload API
- `attachments` (array of object | null; ≤ 10 items): Multi-image message (≤10 images)
  - `attachments[].type` (string; one of image)
  - `attachments[].url` (string (uri))
- `quick_replies` (array of object | null; ≤ 13 items)
  - `quick_replies[].title` (string; ≤ 20 characters)
  - `quick_replies[].payload` (string | null)
- `buttons` (array of object | null; ≤ 3 items)
  - `buttons[].title` (string)
  - `buttons[].url` (string (uri) | null)
  - `buttons[].payload` (string | null)
- `elements` (array of object | null; ≤ 10 items): Generic template carousel
  - `elements[].title` (string)
  - `elements[].subtitle` (string | null)
  - `elements[].image_url` (string (uri) | null)
  - `elements[].buttons` (array of object | null)
    - `elements[].buttons[].type` (string)
    - `elements[].buttons[].title` (string)
    - `elements[].buttons[].url` (string (uri) | null)
    - `elements[].buttons[].payload` (string | null)
- `sticker` (string | null; one of like_heart)
- `media_share_id` (string | null): Own post id to share (MEDIA_SHARE)
- `reply_to` (string | null): Message id to reply to
- `human_agent` (boolean | null): Send with the HUMAN_AGENT tag (up to 7 days after the last user message; needs the Human Agent feature)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/comments/ITEM_ID/private-reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "attachment": {
      "type": "image",
      "url": "https://example.com"
    },
    "attachments": [
      {
        "type": "image",
        "url": "https://example.com"
      }
    ],
    "quick_replies": [
      {
        "title": "string",
        "payload": "string"
      }
    ],
    "buttons": [
      {
        "title": "string",
        "url": "https://example.com"
      }
    ]
  }'
```

Response 200:

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

## Instagram: List Mentions & tags

`GET /accounts/{accountId}/instagram/mentions`

Media you are tagged in. Caption/comment @mentions arrive by webhook; look them up by id and reply here. Story mentions arrive as DMs. Cursor pagination: pass next_cursor back as cursor. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `read` · MCP tool: `instagram-mentions-list`

### Path parameters

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

### Query parameters

- `limit` (integer; 1–100)
- `after` (string): Cursor from next_cursor

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "caption": "string",
      "media_type": "IMAGE",
      "media_product_type": "FEED",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "https://example.com",
      "shortcode": "string",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "username": "string",
      "like_count": 1,
      "comments_count": 1,
      "is_comment_enabled": true,
      "is_shared_to_feed": true,
      "alt_text": "string",
      "children": [
        {
          "id": "string",
          "media_type": "IMAGE",
          "media_url": "https://example.com",
          "thumbnail_url": "https://example.com"
        }
      ],
      "reposts_count": 1,
      "saved_count": 1,
      "shares_count": 1,
      "media_audio_type": "MUSIC",
      "is_ai_generated": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Instagram: Get a Mentions & tags item

`GET /accounts/{accountId}/instagram/mentions/{itemId}`

Mentioned media by id (from the mentions webhook). Media you are tagged in. Caption/comment @mentions arrive by webhook; look them up by id and reply here. Story mentions arrive as DMs. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `read` · MCP tool: `instagram-mentions-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/instagram/mentions/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "caption": "string",
  "media_type": "IMAGE",
  "media_product_type": "FEED",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "shortcode": "string",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "username": "string",
  "like_count": 1,
  "comments_count": 1,
  "is_comment_enabled": true,
  "is_shared_to_feed": true,
  "alt_text": "string",
  "children": [
    {
      "id": "string",
      "media_type": "IMAGE",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com"
    }
  ],
  "reposts_count": 1,
  "saved_count": 1,
  "shares_count": 1,
  "media_audio_type": "MUSIC",
  "is_ai_generated": true
}
```

## Instagram: Reply to mention (Mentions & tags)

`POST /accounts/{accountId}/instagram/mentions/{itemId}/reply`

Reply on the caption (no comment_id) or on the mentioning comment. Media you are tagged in. Caption/comment @mentions arrive by webhook; look them up by id and reply here. Story mentions arrive as DMs. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `instagram-mentions-reply` · Zernio: `POST /v1/inbox/mentions/reply`, `POST /v1/inbox/posts/{postId}/like`, `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

### 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

- `comment_id` (string | null)
- `message` (string; required; ≤ 2200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/mentions/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "comment_id": "string",
    "message": "string"
  }'
```

Response 200:

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

## Instagram: Look up mentioning comment (Mentions & tags)

`POST /accounts/{accountId}/instagram/mentions/mentioned-comment`

Look up mentioning comment. Media you are tagged in. Caption/comment @mentions arrive by webhook; look them up by id and reply here. Story mentions arrive as DMs. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `instagram-mentions-mentioned-comment`

### 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

- `comment_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/mentions/mentioned-comment" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "comment_id": "string"
  }'
```

Response 200:

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

## Instagram: Like (Mentions & tags)

`POST /accounts/{accountId}/instagram/mentions/{itemId}/like`

Like. Media you are tagged in. Caption/comment @mentions arrive by webhook; look them up by id and reply here. Story mentions arrive as DMs. Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `instagram-mentions-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/instagram/mentions/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
}
```

## Instagram: List Direct

`GET /accounts/{accountId}/instagram/conversations`

1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Cursor pagination: pass next_cursor back as cursor. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `read` · MCP tool: `instagram-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

- `limit` (integer; 1–100)
- `after` (string): Cursor from next_cursor
- `user_id` (string | null): IGSID: find the thread with this user

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/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",
      "participants": [
        {
          "id": "string",
          "name": "string",
          "username": "string"
        }
      ],
      "participant": {
        "id": "string",
        "name": "string",
        "username": "string"
      },
      "messages": [
        {
          "id": "string",
          "text": "string",
          "direction": "in",
          "sent_at": "2026-10-13T09:00:00.000Z",
          "from_id": "string",
          "attachments": []
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Instagram: Get a Direct item

`GET /accounts/{accountId}/instagram/conversations/{itemId}`

Thread with messages. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `read` · MCP tool: `instagram-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/instagram/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",
  "participants": [
    {
      "id": "string",
      "name": "string",
      "username": "string"
    }
  ],
  "participant": {
    "id": "string",
    "name": "string",
    "username": "string"
  },
  "messages": [
    {
      "id": "string",
      "text": "string",
      "direction": "in",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "from_id": "string",
      "attachments": [
        {
          "type": "string",
          "url": "https://example.com"
        }
      ],
      "reply_to": "+15551234567",
      "story_reply": {
        "id": "string",
        "url": "https://example.com"
      }
    }
  ]
}
```

## Instagram: Send message (Direct)

`POST /accounts/{accountId}/instagram/conversations/{itemId}/send`

Send message. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `instagram-conversations-send` · Zernio: `POST /v1/inbox/conversations/{conversationId}/messages`, `POST /v1/inbox/conversations/{conversationId}/typing`, `POST /v1/inbox/conversations/{conversationId}/read`, `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

- `recipient_id` (string | null)
- `text` (string | null; ≤ 1000 characters): ≤1000 bytes; URLs must be valid
- `attachment` (object | null)
  - `attachment.type` (string; one of image, video, audio, file)
  - `attachment.url` (string (uri) | null)
  - `attachment.media_id` (string | null)
  - `attachment.attachment_id` (string | null): Reusable id from the Attachment Upload API
- `attachments` (array of object | null; ≤ 10 items): Multi-image message (≤10 images)
  - `attachments[].type` (string; one of image)
  - `attachments[].url` (string (uri))
- `quick_replies` (array of object | null; ≤ 13 items)
  - `quick_replies[].title` (string; ≤ 20 characters)
  - `quick_replies[].payload` (string | null)
- `buttons` (array of object | null; ≤ 3 items)
  - `buttons[].title` (string)
  - `buttons[].url` (string (uri) | null)
  - `buttons[].payload` (string | null)
- `elements` (array of object | null; ≤ 10 items): Generic template carousel
  - `elements[].title` (string)
  - `elements[].subtitle` (string | null)
  - `elements[].image_url` (string (uri) | null)
  - `elements[].buttons` (array of object | null)
    - `elements[].buttons[].type` (string)
    - `elements[].buttons[].title` (string)
    - `elements[].buttons[].url` (string (uri) | null)
    - `elements[].buttons[].payload` (string | null)
- `sticker` (string | null; one of like_heart)
- `media_share_id` (string | null): Own post id to share (MEDIA_SHARE)
- `reply_to` (string | null): Message id to reply to
- `human_agent` (boolean | null): Send with the HUMAN_AGENT tag (up to 7 days after the last user message; needs the Human Agent feature)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/conversations/ITEM_ID/send" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_id": "string",
    "text": "string",
    "attachment": {
      "type": "image",
      "url": "https://example.com"
    },
    "attachments": [
      {
        "type": "image",
        "url": "https://example.com"
      }
    ],
    "quick_replies": [
      {
        "title": "string",
        "payload": "string"
      }
    ]
  }'
```

Response 200:

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

## Instagram: React (Direct)

`POST /accounts/{accountId}/instagram/conversations/{itemId}/react`

React. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `instagram-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

- `message_id` (string; required)
- `reaction` (string | null): Emoji or "love"
- `recipient_id` (string | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/conversations/ITEM_ID/react" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message_id": "string",
    "reaction": "love",
    "recipient_id": "string"
  }'
```

Response 200:

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

## Instagram: Remove reaction (Direct)

`POST /accounts/{accountId}/instagram/conversations/{itemId}/unreact`

Remove reaction. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `instagram-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

- `message_id` (string; required)
- `recipient_id` (string | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/conversations/ITEM_ID/unreact" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message_id": "string",
    "recipient_id": "string"
  }'
```

Response 200:

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

## Instagram: Typing indicator (Direct)

`POST /accounts/{accountId}/instagram/conversations/{itemId}/typing`

Typing indicator. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `instagram-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

- `on` (boolean | null)
- `recipient_id` (string | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/conversations/ITEM_ID/typing" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "on": true,
    "recipient_id": "string"
  }'
```

Response 200:

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

## Instagram: Mark as seen (Direct)

`POST /accounts/{accountId}/instagram/conversations/{itemId}/mark-seen`

Mark as seen. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `instagram-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

- `recipient_id` (string | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/conversations/ITEM_ID/mark-seen" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_id": "string"
  }'
```

Response 200:

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

## Instagram: Block user (Direct)

`POST /accounts/{accountId}/instagram/conversations/{itemId}/block`

Block user. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Destructive. Requires scopes: instagram_basic, instagram_manage_messages, business_management. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `instagram-conversations-block`

### 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

- `recipient_id` (string | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/conversations/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_id": "string"
  }'
```

Response 200:

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

## Instagram: Unblock user (Direct)

`POST /accounts/{accountId}/instagram/conversations/{itemId}/unblock`

Unblock user. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires scopes: instagram_basic, instagram_manage_messages, business_management. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `instagram-conversations-unblock`

### 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

- `recipient_id` (string | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/conversations/ITEM_ID/unblock" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_id": "string"
  }'
```

Response 200:

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

## Instagram: Move to spam (Direct)

`POST /accounts/{accountId}/instagram/conversations/{itemId}/spam`

Move to spam. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Destructive. Requires scopes: instagram_basic, instagram_manage_messages, business_management. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: `write` · MCP tool: `instagram-conversations-spam`

### 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

- `recipient_id` (string | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/conversations/ITEM_ID/spam" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_id": "string"
  }'
```

Response 200:

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

## Instagram: Get Ice breakers

`GET /accounts/{accountId}/instagram/ice-breakers`

Up to 4 FAQ questions shown when someone opens a new conversation (per locale). Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/ice-breakers Generic route: /v1/accounts/{accountId}/focus/ice-breakers.

Access: `read` · MCP tool: `instagram-ice-breakers-get` · Zernio: `GET /v1/accounts/{accountId}/instagram-ice-breakers`

### Path parameters

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

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

Response 200:

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

## Instagram: Update Ice breakers

`PATCH /accounts/{accountId}/instagram/ice-breakers`

Up to 4 FAQ questions shown when someone opens a new conversation (per locale). Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/ice-breakers Generic route: /v1/accounts/{accountId}/focus/ice-breakers.

Access: `write` · MCP tool: `instagram-ice-breakers-update` · Zernio: `PUT /v1/accounts/{accountId}/instagram-ice-breakers`

### Path parameters

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

### Body

- `ice_breakers` (array of object)
  - `ice_breakers[].locale` (string | null)
  - `ice_breakers[].call_to_actions` (array of object; ≤ 4 items)
    - `ice_breakers[].call_to_actions[].question` (string; required; ≤ 80 characters)
    - `ice_breakers[].call_to_actions[].payload` (string | null)
- `questions` (array of object | null; ≤ 4 items)
  - `questions[].question` (string; required; ≤ 80 characters)
  - `questions[].payload` (string | null)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ice_breakers": [
      {
        "locale": "en",
        "call_to_actions": [
          {
            "question": "string",
            "payload": "string"
          }
        ]
      }
    ],
    "questions": [
      {
        "question": "string",
        "payload": "string"
      }
    ]
  }'
```

Response 200:

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

## Instagram: Delete Ice breakers

`DELETE /accounts/{accountId}/instagram/ice-breakers`

Up to 4 FAQ questions shown when someone opens a new conversation (per locale). Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/ice-breakers Generic route: /v1/accounts/{accountId}/focus/ice-breakers.

Access: `write` · MCP tool: `instagram-ice-breakers-delete` · Zernio: `DELETE /v1/accounts/{accountId}/instagram-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/instagram/ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

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

## Instagram: Get Persistent menu

`GET /accounts/{accountId}/instagram/persistent-menu`

Menu of web links and postbacks available in every conversation. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/persistent-menu Generic route: /v1/accounts/{accountId}/focus/persistent-menu.

Access: `read` · MCP tool: `instagram-persistent-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/instagram/persistent-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "persistent_menu": [
    {
      "locale": "default",
      "composer_input_disabled": true,
      "call_to_actions": [
        {
          "title": "string"
        }
      ]
    }
  ]
}
```

## Instagram: Update Persistent menu

`PATCH /accounts/{accountId}/instagram/persistent-menu`

Menu of web links and postbacks available in every conversation. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/persistent-menu Generic route: /v1/accounts/{accountId}/focus/persistent-menu.

Access: `write` · MCP tool: `instagram-persistent-menu-update` · Zernio: `PUT /v1/accounts/{accountId}/messenger-menu`

### Path parameters

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

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/persistent-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "persistent_menu": [
    {
      "locale": "default",
      "composer_input_disabled": true,
      "call_to_actions": [
        {
          "title": "string"
        }
      ]
    }
  ]
}
```

## Instagram: Delete Persistent menu

`DELETE /accounts/{accountId}/instagram/persistent-menu`

Menu of web links and postbacks available in every conversation. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/persistent-menu Generic route: /v1/accounts/{accountId}/focus/persistent-menu.

Access: `write` · MCP tool: `instagram-persistent-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/instagram/persistent-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

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

## Instagram: Get a People item

`GET /accounts/{accountId}/instagram/people/{itemId}`

Profile and follow status of a user who messaged the account (by IGSID). Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/user-profile Generic route: /v1/accounts/{accountId}/focus/people.

Access: `read` · MCP tool: `instagram-people-get` · Zernio: `GET /v1/accounts/{accountId}/follow-status/{userId}`

### 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/instagram/people/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "user_id": "string",
  "username": "string",
  "name": "string",
  "is_follower": true,
  "is_followed_by_account": true,
  "follower_count": 1,
  "is_verified": true,
  "unavailable_reason": "consent_required"
}
```

## Instagram: Create a Reusable attachments item

`POST /accounts/{accountId}/instagram/message-attachments`

Upload media once and reuse its attachment_id in DMs. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Generic route: /v1/accounts/{accountId}/focus/message-attachments.

Access: `write` · MCP tool: `instagram-message-attachments-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

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

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/message-attachments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "image",
    "url": "https://example.com"
  }'
```

Response 201:

```json
{
  "attachment_id": "string"
}
```

## Instagram: Get Account

`GET /accounts/{accountId}/instagram/account-insights`

Views, reach, accounts engaged, interactions (likes, comments, saves, shares, replies, reposts), follows/unfollows and profile link taps. Max 90 days, up to 48 h delay; only reach has a daily series. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/api-reference/instagram-user/insights Generic route: /v1/accounts/{accountId}/focus/account-insights.

Access: `read` · MCP tool: `instagram-account-insights-get` · Zernio: `GET /v1/analytics/instagram/account-insights`

### Path parameters

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

### Query parameters

- `since` (string (date-time) | null)
- `until` (string (date-time) | null)
- `metrics` (array of string | null)
- `metric_type` (string | null; one of total_value, time_series)
- `breakdown` (string | null; one of media_product_type, follow_type, contact_button_type)

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

Response 200:

```json
{
  "date_range": {
    "since": "string",
    "until": "string"
  },
  "metric_type": "total_value",
  "breakdown": "string",
  "metrics": {
    "key": {
      "total": 1.5,
      "values": [
        {
          "date": "2026-10-13",
          "value": 1.5
        }
      ],
      "breakdown": [
        {
          "dimensions": [],
          "value": 1.5
        }
      ]
    }
  },
  "unavailable_metrics": [
    {
      "metric": "string",
      "reason": "string"
    }
  ]
}
```

## Instagram: Normalized summary (Account)

`POST /accounts/{accountId}/instagram/account-insights/summary`

Normalized summary. Views, reach, accounts engaged, interactions (likes, comments, saves, shares, replies, reposts), follows/unfollows and profile link taps. Max 90 days, up to 48 h delay; only reach has a daily series. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/api-reference/instagram-user/insights Generic route: /v1/accounts/{accountId}/focus/account-insights.

Access: `write` · MCP tool: `instagram-account-insights-summary`

### 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-time) | null)
- `until` (string (date-time) | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/account-insights/summary" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "since": "2026-10-13T09:00:00.000Z",
    "until": "2026-10-13T09:00:00.000Z"
  }'
```

Response 200:

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

## Instagram: List Content

`GET /accounts/{accountId}/instagram/content-insights`

Per-post performance ranked by a metric: views, reach, interactions, Reels watch time and skip rate. Cursor pagination: pass next_cursor back as cursor. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/reference/instagram-media/insights Generic route: /v1/accounts/{accountId}/focus/content-insights.

Access: `read` · MCP tool: `instagram-content-insights-list`

### Path parameters

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

### Query parameters

- `since` (string (date-time) | null)
- `until` (string (date-time) | null)
- `limit` (integer | null; ≤ 50)
- `metric` (string | null; one of views, reach, likes, comments, shares, saves, engagements, engagement_rate)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "caption": "string",
      "media_product_type": "string",
      "permalink": "https://example.com",
      "thumbnail_url": "https://example.com",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "views": 1.5,
      "reach": 1.5,
      "likes": 1.5,
      "comments": 1.5,
      "shares": 1.5,
      "saves": 1.5,
      "engagements": 1.5,
      "engagement_rate": 1.5,
      "watch_time_seconds": 1.5,
      "avg_view_duration_seconds": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Instagram: Get a Content item

`GET /accounts/{accountId}/instagram/content-insights/{itemId}`

Raw insights for one media. Per-post performance ranked by a metric: views, reach, interactions, Reels watch time and skip rate. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/reference/instagram-media/insights Generic route: /v1/accounts/{accountId}/focus/content-insights.

Access: `read` · MCP tool: `instagram-content-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/instagram/content-insights/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "caption": "string",
  "media_product_type": "string",
  "permalink": "https://example.com",
  "thumbnail_url": "https://example.com",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "views": 1.5,
  "reach": 1.5,
  "likes": 1.5,
  "comments": 1.5,
  "shares": 1.5,
  "saves": 1.5,
  "engagements": 1.5,
  "engagement_rate": 1.5,
  "watch_time_seconds": 1.5,
  "avg_view_duration_seconds": 1.5
}
```

## Instagram: Get Audience

`GET /accounts/{accountId}/instagram/audience`

Follower or engaged-audience demographics by age, gender, country and city (top 45; ≥100 followers). Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/api-reference/instagram-user/insights Generic route: /v1/accounts/{accountId}/focus/audience.

Access: `read` · MCP tool: `instagram-audience-get` · Zernio: `GET /v1/analytics/instagram/demographics`

### Path parameters

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

### Query parameters

- `metric` (string | null; one of follower_demographics, engaged_audience_demographics)
- `timeframe` (string | null; one of this_week, this_month, prev_month, last_14_days, last_30_days, last_90_days)
- `breakdown` (array of string | null)

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

Response 200:

```json
{
  "metric": "follower_demographics",
  "timeframe": "this_week",
  "demographics": {
    "age": [
      {
        "key": "string",
        "value": 1.5
      }
    ],
    "gender": [
      {
        "key": "string",
        "value": 1.5
      }
    ],
    "country": [
      {
        "key": "string",
        "value": 1.5
      }
    ],
    "city": [
      {
        "key": "string",
        "value": 1.5
      }
    ]
  }
}
```

## Instagram: Get Best time to post

`GET /accounts/{accountId}/instagram/online-followers`

Hourly online followers for each of the last 30 days, with the best hours. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/api-reference/instagram-user/insights Generic route: /v1/accounts/{accountId}/focus/online-followers.

Access: `read` · MCP tool: `instagram-online-followers-get` · Zernio: `GET /v1/analytics/instagram/online-followers`

### Path parameters

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

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

Response 200:

```json
{
  "days": [
    {
      "date": "string",
      "hours": {}
    }
  ],
  "average_by_hour": [
    {
      "hour": 0,
      "value": 1.5
    }
  ],
  "best_hours": [
    1
  ]
}
```

## Instagram: Get Followers

`GET /accounts/{accountId}/instagram/follower-history`

Follower totals (Socialit daily snapshots) with new followers per day (Instagram, last 30 days) and derived unfollows. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/api-reference/instagram-user/insights Generic route: /v1/accounts/{accountId}/focus/follower-history.

Access: `read` · MCP tool: `instagram-follower-history-get` · Zernio: `GET /v1/analytics/instagram/follower-history`

### Path parameters

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

### Query parameters

- `since` (string (date-time) | null)
- `until` (string (date-time) | null)

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

Response 200:

```json
{
  "current_followers": 1,
  "metrics": {
    "follower_count": [
      {
        "date": "2026-10-13",
        "value": 1.5
      }
    ],
    "followers_gained": [
      {
        "date": "2026-10-13",
        "value": 1.5
      }
    ],
    "followers_lost": [
      {
        "date": "2026-10-13",
        "value": 1.5
      }
    ]
  }
}
```

## Instagram: List Hashtag search

`GET /accounts/{accountId}/instagram/hashtags`

Recently searched hashtags (7-day window). Top and recent (24 h) public media for a hashtag. 30 unique hashtags per rolling 7 days; requires the Instagram Public Content Access feature (App Review). Cursor pagination: pass next_cursor back as cursor. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/hashtag-search Generic route: /v1/accounts/{accountId}/focus/hashtags.

Access: `read` · MCP tool: `instagram-hashtags-list`

### Path parameters

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

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/hashtags" \
  -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"
}
```

## Instagram: Create a Hashtag search item

`POST /accounts/{accountId}/instagram/hashtags`

Search a hashtag (counts toward the 30/7-day budget). Top and recent (24 h) public media for a hashtag. 30 unique hashtags per rolling 7 days; requires the Instagram Public Content Access feature (App Review). Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/hashtag-search Generic route: /v1/accounts/{accountId}/focus/hashtags.

Access: `write` · MCP tool: `instagram-hashtags-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

- `q` (string; required): Hashtag without #

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/hashtags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "string"
  }'
```

Response 201:

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

## Instagram: Get a Hashtag search item

`GET /accounts/{accountId}/instagram/hashtags/{itemId}`

Top and recent (24 h) public media for a hashtag. 30 unique hashtags per rolling 7 days; requires the Instagram Public Content Access feature (App Review). Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/hashtag-search Generic route: /v1/accounts/{accountId}/focus/hashtags.

Access: `read` · MCP tool: `instagram-hashtags-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/instagram/hashtags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

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

## Instagram: Top media (Hashtag search)

`POST /accounts/{accountId}/instagram/hashtags/{itemId}/top-media`

Top media. Top and recent (24 h) public media for a hashtag. 30 unique hashtags per rolling 7 days; requires the Instagram Public Content Access feature (App Review). Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/hashtag-search Generic route: /v1/accounts/{accountId}/focus/hashtags.

Access: `write` · MCP tool: `instagram-hashtags-top-media`

### 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

- `limit` (integer; 1–100)
- `after` (string): Cursor from next_cursor

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/hashtags/ITEM_ID/top-media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "after": "string"
  }'
```

Response 200:

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

## Instagram: Recent media (24 h) (Hashtag search)

`POST /accounts/{accountId}/instagram/hashtags/{itemId}/recent-media`

Recent media (24 h). Top and recent (24 h) public media for a hashtag. 30 unique hashtags per rolling 7 days; requires the Instagram Public Content Access feature (App Review). Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/hashtag-search Generic route: /v1/accounts/{accountId}/focus/hashtags.

Access: `write` · MCP tool: `instagram-hashtags-recent-media`

### 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

- `limit` (integer; 1–100)
- `after` (string): Cursor from next_cursor

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/hashtags/ITEM_ID/recent-media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "after": "string"
  }'
```

Response 200:

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

## Instagram: Get a Competitors item

`GET /accounts/{accountId}/instagram/business-discovery/{itemId}`

Public profile and recent media of another Business/Creator account (not private, personal or age-gated). Reels include cross-app view_count. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/business_discovery Generic route: /v1/accounts/{accountId}/focus/business-discovery.

Access: `read` · MCP tool: `instagram-business-discovery-get` · Zernio: `GET /v1/accounts/{accountId}/instagram/business-discovery`

### 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

- `limit` (integer | null; ≤ 50)
- `after` (string | null)

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

Response 200:

```json
{
  "profile": {
    "id": "string",
    "username": "string",
    "name": "string",
    "biography": "string",
    "website": "https://example.com",
    "profile_picture_url": "https://example.com",
    "followers_count": 1,
    "follows_count": 1,
    "media_count": 1
  },
  "media": [
    {
      "id": "string",
      "caption": "string",
      "media_type": "IMAGE",
      "media_product_type": "FEED",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "https://example.com",
      "shortcode": "string",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "username": "string",
      "like_count": 1,
      "comments_count": 1,
      "is_comment_enabled": true,
      "is_shared_to_feed": true,
      "alt_text": "string",
      "children": [
        {
          "id": "string",
          "media_type": "IMAGE",
          "media_url": "https://example.com",
          "thumbnail_url": "https://example.com"
        }
      ],
      "reposts_count": 1,
      "saved_count": 1,
      "shares_count": 1,
      "media_audio_type": "MUSIC",
      "is_ai_generated": true,
      "view_count": 1
    }
  ],
  "next_cursor": "string"
}
```

## Instagram: Create a Embed item

`POST /accounts/{accountId}/instagram/oembed`

Embed HTML for a public Instagram post or Reel URL. Network docs: https://developers.facebook.com/docs/instagram-platform/oembed Generic route: /v1/accounts/{accountId}/focus/oembed.

Access: `write` · MCP tool: `instagram-oembed-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

- `url` (string (uri); required)
- `maxwidth` (integer | null)
- `hidecaption` (boolean | null)
- `omitscript` (boolean | null)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/oembed" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "maxwidth": 1,
    "hidecaption": true,
    "omitscript": true
  }'
```

Response 201:

```json
{
  "html": "string",
  "provider_name": "string",
  "width": 1,
  "type": "string",
  "version": "string"
}
```

## Instagram: List Catalogs

`GET /accounts/{accountId}/instagram/catalogs`

Catalogs eligible for product tagging (approved Instagram Shop; user must be catalog admin). Cursor pagination: pass next_cursor back as cursor. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: /v1/accounts/{accountId}/focus/catalogs.

Access: `read` · MCP tool: `instagram-catalogs-list`

### Path parameters

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

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

Response 200:

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

## Instagram: List Products

`GET /accounts/{accountId}/instagram/catalog-products`

Cursor pagination: pass next_cursor back as cursor. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: /v1/accounts/{accountId}/focus/catalog-products.

Access: `read` · MCP tool: `instagram-catalog-products-list`

### Path parameters

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

### Query parameters

- `limit` (integer; 1–100)
- `after` (string): Cursor from next_cursor
- `catalog_id` (string)
- `q` (string | null)

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

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "product_id": "string",
      "merchant_id": "string",
      "product_name": "string",
      "image_url": "https://example.com",
      "retailer_id": "string",
      "review_status": "string",
      "is_checkout_flow": true,
      "product_variants": [
        {
          "product_id": "string",
          "variant_name": "string"
        }
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Instagram: Appeal rejection (Products)

`POST /accounts/{accountId}/instagram/catalog-products/{itemId}/appeal`

Appeal rejection. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: /v1/accounts/{accountId}/focus/catalog-products.

Access: `write` · MCP tool: `instagram-catalog-products-appeal`

### 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

- `appeal_reason` (string | null): Omit to read the appeal status

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/catalog-products/ITEM_ID/appeal" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "appeal_reason": "string"
  }'
```

Response 200:

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

## Instagram: Get a Product tags item

`GET /accounts/{accountId}/instagram/product-tags/{itemId}`

Product tags on a published media item (by media id), with review status. ≤5 per item. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: /v1/accounts/{accountId}/focus/product-tags.

Access: `read` · MCP tool: `instagram-product-tags-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/instagram/product-tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "media_id": "string",
  "tags": [
    {
      "product_id": "string",
      "name": "string",
      "x": 1.5,
      "y": 1.5,
      "review_status": "string"
    }
  ]
}
```

## Instagram: Update a Product tags item

`PATCH /accounts/{accountId}/instagram/product-tags/{itemId}`

Product tags on a published media item (by media id), with review status. ≤5 per item. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: /v1/accounts/{accountId}/focus/product-tags.

Access: `write` · MCP tool: `instagram-product-tags-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

- `tags` (array of object; required; ≤ 5 items)
  - `tags[].product_id` (string; required)
  - `tags[].x` (number | null; 0–1)
  - `tags[].y` (number | null; 0–1)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/product-tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tags": [
      {
        "product_id": "string",
        "x": 0
      }
    ]
  }'
```

Response 200:

```json
{
  "media_id": "string",
  "tags": [
    {
      "product_id": "string",
      "name": "string",
      "x": 1.5,
      "y": 1.5,
      "review_status": "string"
    }
  ]
}
```

## Instagram: Remove tags (Product tags)

`POST /accounts/{accountId}/instagram/product-tags/{itemId}/remove`

Remove tags. Product tags on a published media item (by media id), with review status. ≤5 per item. Destructive. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: /v1/accounts/{accountId}/focus/product-tags.

Access: `write` · MCP tool: `instagram-product-tags-remove`

### 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

- `product_ids` (array of string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram/product-tags/ITEM_ID/remove" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_ids": [
      "string"
    ]
  }'
```

Response 200:

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


---

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