Skip to content
Docs

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

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits103 endpointsMCP toolset focus_instagram

Stories

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

mediaarray of objectrequired

1–10 items

Show 4 item attributes
media_idstring | null
urlstring (uri) | null
typestring | null

imagevideo

alt_textstring | null

≤ 1000 characters

user_tagsarray of object | null
Show 4 item attributes
usernamestring
xnumber | null
ynumber | null
media_indexinteger | null

Returns object

idstring
media_typestring

IMAGEVIDEO

media_product_typestring

STORY

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
timestampstring (date-time)
usernamestring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/stories
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

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

Try it with MCPAsk your agent to call instagram-stories-delete (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/stories/{itemId}/insights
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

Profile

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

Try it with MCPAsk your agent to call instagram-profile-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringread-only
usernamestringread-only
namestring | nullread-only
biographystring | nullread-only
websitestring (uri) | nullread-only
profile_picture_urlstring (uri) | nullread-only
followers_countinteger | nullread-only
follows_countinteger | nullread-only
media_countinteger | nullread-only
account_typestring | nullread-only

BUSINESSMEDIA_CREATOR

login_typestringread-only

instagram_loginfacebook_login

page_idstring | nullread-only

Linked Facebook Page (Facebook Login)

shopping_product_tag_eligibilityboolean | nullread-only
profile_urlstring (uri) | nullread-only
editablebooleanread-only

Responses

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

Webhook subscriptions

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

Try it with MCPAsk your agent to call instagram-webhook-subscriptions-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstring | null
namestring | null
subscribed_fieldsarray of string
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-webhook-subscriptions-create (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

fieldsarray of string | null

Defaults to every supported field

Returns object

idstring | null
namestring | null
subscribed_fieldsarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/webhook-subscriptions
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

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

Try it with MCPAsk your agent to call instagram-webhook-subscriptions-unsubscribe (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/webhook-subscriptions/unsubscribe
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

Media

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: readZernio: GET /v1/accounts/{accountId}/posts

Try it with MCPAsk your agent to call instagram-media-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

afterstring

Cursor from next_cursor

sincestring (date-time) | null
untilstring (date-time) | null
media_typestring | null

IMAGEVIDEOCAROUSEL_ALBUM

product_typestring | null

FEEDREELS

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 21 item attributes
idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

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

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-media-create (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

captionstring | null

≤2,200 chars, ≤30 hashtags, ≤20 @mentions. Ignored for Stories.

≤ 2200 characters

mediaarray of objectrequired

1–10 items

Show 4 item attributes
media_idstring | null
urlstring (uri) | null
typestring | null

imagevideo

alt_textstring | null

≤ 1000 characters

optionsobject
Show 21 child attributes
contentTypestringdefault: "auto"

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

autofeedreelstorycarousel

shareToFeedbooleandefault: true

Reels only: also show the Reel in the main feed.

collaboratorsarray of string

Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).

≤ 3 items

userTagsarray of string | object

People tags (feed, Reels, carousel items, Stories).

≤ 20 items

One of 2 shapes

Option 1 string

Username (leading @ stripped). Images default to the centre (0.5, 0.5).

Option 2 object

usernamestringrequired
xnumber

From the left edge. Required for photos (defaults to 0.5), ignored for video.

0–1

ynumber

From the top edge. Required for photos (defaults to 0.5), ignored for video.

0–1

mediaIndexinteger

Carousel slide index.

locationIdstring

Facebook Page id with location data (feed, Reels, carousels; not Stories).

pattern ^[0-9]+$

altTextstring

Fallback alt text for images (per-item media[].altText wins). Images only.

≤ 1000 characters

coverUrlstring (uri)

Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl.

thumbOffsetinteger

Reel cover frame offset in milliseconds.

audioNamestring

Rename the Reel original audio (once, at creation).

audioConfigurationobject

Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).

Show 3 child attributes
audioIdstringrequired
audioVolumeintegerdefault: 100

0–100

videoVolumeintegerdefault: 100

0 mutes the original sound.

0–100

muteAudiobooleandefault: false

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

trialParamsobject

Trial Reel shown to non-followers first (Reels only).

Show 1 child attributes
graduationStrategystringrequired

MANUALSS_PERFORMANCE

isAiGeneratedbooleandefault: false

Meta "AI info" label (carousel: parent only).

isPaidPartnershipbooleandefault: false

"Paid partnership" label (Facebook Login only; not Stories).

brandedContentSponsorsarray of string

Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.

≤ 2 items

productTagsarray of object

Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.

Show 4 item attributes
productIdstringrequired
xnumber

0–1

ynumber

0–1

mediaIndexintegerdefault: 0
commentsEnabledbooleandefault: true

false disables comments right after publishing (best-effort; not Stories).

firstCommentstring

Posted as the first comment (not Stories). Also read from post.firstComment.

≤ 2200 characters

uploadTypestringdefault: "url"

resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url.

urlresumable

checkPublishingLimitbooleandefault: false

Read content_publishing_limit first and fail fast when the 24 h quota is used up.

containerIdstring

Publish a container created earlier (≤24 h) instead of creating a new one.

first_commentstring | null

≤ 2200 characters

Returns object

idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

is_ai_generatedboolean | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/media
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

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

Try it with MCPAsk your agent to call instagram-media-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

is_ai_generatedboolean | null

Responses

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

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

Try it with MCPAsk your agent to call instagram-media-update (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

comments_enabledboolean

Returns object

idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

is_ai_generatedboolean | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/instagram/media/{itemId}
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

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

Try it with MCPAsk your agent to call instagram-media-delete (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-media-enable-comments (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/media/{itemId}/enable-comments
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-media-disable-comments (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/media/{itemId}/disable-comments
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-media-comment (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

messagestringrequired

≤ 2200 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/media/{itemId}/comment
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-media-insights (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/media/{itemId}/insights
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-media-children (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/media/{itemId}/children
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-media-collaborators (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/media/{itemId}/collaborators
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-media-like (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/media/{itemId}/like
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-media-unlike (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/media/{itemId}/unlike
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

Reels

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

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

afterstring

Cursor from next_cursor

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 21 item attributes
idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

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

Responses

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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

captionstring | null

≤ 2200 characters

videoobjectrequired
Show 2 child attributes
media_idstring | null
urlstring (uri) | null
share_to_feedboolean | nulldefault: true
cover_urlstring (uri) | null
thumb_offsetinteger | null
audio_namestring | null
audio_idstring | null

Audio API track (Facebook Login)

trialstring | null

Publish as a trial Reel

MANUALSS_PERFORMANCE

collaboratorsarray of string | null

≤ 3 items

location_idstring | null
first_commentstring | null

Returns object

idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

is_ai_generatedboolean | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/reels
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

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

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

is_ai_generatedboolean | null

Responses

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

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

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-reels-enable-comments (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/reels/{itemId}/enable-comments
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-reels-disable-comments (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/reels/{itemId}/disable-comments
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-reels-comment (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

messagestringrequired

≤ 2200 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/reels/{itemId}/comment
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/reels/{itemId}/insights
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-reels-children (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/reels/{itemId}/children
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/reels/{itemId}/collaborators
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-reels-like (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/reels/{itemId}/like
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-reels-unlike (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/reels/{itemId}/unlike
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

Containers

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

Try it with MCPAsk your agent to call instagram-containers-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
status_codestring | null

IN_PROGRESSFINISHEDERROREXPIREDPUBLISHED

statusstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-containers-create (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

image_urlstring (uri) | null
video_urlstring (uri) | null
media_typestring | null

REELSSTORIESCAROUSELVIDEO

captionstring | null
is_carousel_itemboolean | null
childrenarray of string | null
share_to_feedboolean | null
cover_urlstring (uri) | null
thumb_offsetinteger | null
location_idstring | null
alt_textstring | null
collaboratorsarray of string | null
user_tagsarray of object | null
Show 3 item attributes
usernamestring
xnumber | null
ynumber | null

Returns object

idstring
status_codestring | null

IN_PROGRESSFINISHEDERROREXPIREDPUBLISHED

statusstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/containers
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-containers-publish (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/containers/{itemId}/publish
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

Scheduled

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

Try it with MCPAsk your agent to call instagram-scheduled-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

statusstring | null

draftscheduledfailed

fromstring (date-time) | null
tostring (date-time) | null

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
statusstring

draftscheduledpublishingpublishedfailed

contentstring | null

≤ 2200 characters

scheduled_forstring (date-time) | null
mediaarray of object | null

1–10 items

Show 4 item attributes
media_idstring | null
urlstring (uri) | null
typestring | null

imagevideo

alt_textstring | null

≤ 1000 characters

platform_optionsobject | null
Show 21 child attributes
contentTypestringdefault: "auto"

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

autofeedreelstorycarousel

shareToFeedbooleandefault: true

Reels only: also show the Reel in the main feed.

collaboratorsarray of string

Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).

≤ 3 items

userTagsarray of string | object

People tags (feed, Reels, carousel items, Stories).

≤ 20 items

One of 2 shapes

Option 1 string

Username (leading @ stripped). Images default to the centre (0.5, 0.5).

Option 2 object

usernamestringrequired
xnumber

From the left edge. Required for photos (defaults to 0.5), ignored for video.

0–1

ynumber

From the top edge. Required for photos (defaults to 0.5), ignored for video.

0–1

mediaIndexinteger

Carousel slide index.

locationIdstring

Facebook Page id with location data (feed, Reels, carousels; not Stories).

pattern ^[0-9]+$

altTextstring

Fallback alt text for images (per-item media[].altText wins). Images only.

≤ 1000 characters

coverUrlstring (uri)

Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl.

thumbOffsetinteger

Reel cover frame offset in milliseconds.

audioNamestring

Rename the Reel original audio (once, at creation).

audioConfigurationobject

Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).

Show 3 child attributes
audioIdstringrequired
audioVolumeintegerdefault: 100

0–100

videoVolumeintegerdefault: 100

0 mutes the original sound.

0–100

muteAudiobooleandefault: false

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

trialParamsobject

Trial Reel shown to non-followers first (Reels only).

Show 1 child attributes
graduationStrategystringrequired

MANUALSS_PERFORMANCE

isAiGeneratedbooleandefault: false

Meta "AI info" label (carousel: parent only).

isPaidPartnershipbooleandefault: false

"Paid partnership" label (Facebook Login only; not Stories).

brandedContentSponsorsarray of string

Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.

≤ 2 items

productTagsarray of object

Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.

Show 4 item attributes
productIdstringrequired
xnumber

0–1

ynumber

0–1

mediaIndexintegerdefault: 0
commentsEnabledbooleandefault: true

false disables comments right after publishing (best-effort; not Stories).

firstCommentstring

Posted as the first comment (not Stories). Also read from post.firstComment.

≤ 2200 characters

uploadTypestringdefault: "url"

resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url.

urlresumable

checkPublishingLimitbooleandefault: false

Read content_publishing_limit first and fail fast when the 24 h quota is used up.

containerIdstring

Publish a container created earlier (≤24 h) instead of creating a new one.

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

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-scheduled-create (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

contentstring | null
scheduled_forstring (date-time) | null
statusstring | null

draftscheduled

mediaarray of object | null

1–10 items

Show 4 item attributes
media_idstring | null
urlstring (uri) | null
typestring | null

imagevideo

alt_textstring | null

≤ 1000 characters

platform_optionsobject | null

Returns object

idstringread-only
statusstring

draftscheduledpublishingpublishedfailed

contentstring | null

≤ 2200 characters

scheduled_forstring (date-time) | null
mediaarray of object | null

1–10 items

Show 4 item attributes
media_idstring | null
urlstring (uri) | null
typestring | null

imagevideo

alt_textstring | null

≤ 1000 characters

platform_optionsobject | null
Show 21 child attributes
contentTypestringdefault: "auto"

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

autofeedreelstorycarousel

shareToFeedbooleandefault: true

Reels only: also show the Reel in the main feed.

collaboratorsarray of string

Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).

≤ 3 items

userTagsarray of string | object

People tags (feed, Reels, carousel items, Stories).

≤ 20 items

One of 2 shapes

Option 1 string

Username (leading @ stripped). Images default to the centre (0.5, 0.5).

Option 2 object

usernamestringrequired
xnumber

From the left edge. Required for photos (defaults to 0.5), ignored for video.

0–1

ynumber

From the top edge. Required for photos (defaults to 0.5), ignored for video.

0–1

mediaIndexinteger

Carousel slide index.

locationIdstring

Facebook Page id with location data (feed, Reels, carousels; not Stories).

pattern ^[0-9]+$

altTextstring

Fallback alt text for images (per-item media[].altText wins). Images only.

≤ 1000 characters

coverUrlstring (uri)

Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl.

thumbOffsetinteger

Reel cover frame offset in milliseconds.

audioNamestring

Rename the Reel original audio (once, at creation).

audioConfigurationobject

Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).

Show 3 child attributes
audioIdstringrequired
audioVolumeintegerdefault: 100

0–100

videoVolumeintegerdefault: 100

0 mutes the original sound.

0–100

muteAudiobooleandefault: false

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

trialParamsobject

Trial Reel shown to non-followers first (Reels only).

Show 1 child attributes
graduationStrategystringrequired

MANUALSS_PERFORMANCE

isAiGeneratedbooleandefault: false

Meta "AI info" label (carousel: parent only).

isPaidPartnershipbooleandefault: false

"Paid partnership" label (Facebook Login only; not Stories).

brandedContentSponsorsarray of string

Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.

≤ 2 items

productTagsarray of object

Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.

Show 4 item attributes
productIdstringrequired
xnumber

0–1

ynumber

0–1

mediaIndexintegerdefault: 0
commentsEnabledbooleandefault: true

false disables comments right after publishing (best-effort; not Stories).

firstCommentstring

Posted as the first comment (not Stories). Also read from post.firstComment.

≤ 2200 characters

uploadTypestringdefault: "url"

resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url.

urlresumable

checkPublishingLimitbooleandefault: false

Read content_publishing_limit first and fail fast when the 24 h quota is used up.

containerIdstring

Publish a container created earlier (≤24 h) instead of creating a new one.

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/scheduled
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

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

Try it with MCPAsk your agent to call instagram-scheduled-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
statusstring

draftscheduledpublishingpublishedfailed

contentstring | null

≤ 2200 characters

scheduled_forstring (date-time) | null
mediaarray of object | null

1–10 items

Show 4 item attributes
media_idstring | null
urlstring (uri) | null
typestring | null

imagevideo

alt_textstring | null

≤ 1000 characters

platform_optionsobject | null
Show 21 child attributes
contentTypestringdefault: "auto"

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

autofeedreelstorycarousel

shareToFeedbooleandefault: true

Reels only: also show the Reel in the main feed.

collaboratorsarray of string

Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).

≤ 3 items

userTagsarray of string | object

People tags (feed, Reels, carousel items, Stories).

≤ 20 items

One of 2 shapes

Option 1 string

Username (leading @ stripped). Images default to the centre (0.5, 0.5).

Option 2 object

usernamestringrequired
xnumber

From the left edge. Required for photos (defaults to 0.5), ignored for video.

0–1

ynumber

From the top edge. Required for photos (defaults to 0.5), ignored for video.

0–1

mediaIndexinteger

Carousel slide index.

locationIdstring

Facebook Page id with location data (feed, Reels, carousels; not Stories).

pattern ^[0-9]+$

altTextstring

Fallback alt text for images (per-item media[].altText wins). Images only.

≤ 1000 characters

coverUrlstring (uri)

Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl.

thumbOffsetinteger

Reel cover frame offset in milliseconds.

audioNamestring

Rename the Reel original audio (once, at creation).

audioConfigurationobject

Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).

Show 3 child attributes
audioIdstringrequired
audioVolumeintegerdefault: 100

0–100

videoVolumeintegerdefault: 100

0 mutes the original sound.

0–100

muteAudiobooleandefault: false

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

trialParamsobject

Trial Reel shown to non-followers first (Reels only).

Show 1 child attributes
graduationStrategystringrequired

MANUALSS_PERFORMANCE

isAiGeneratedbooleandefault: false

Meta "AI info" label (carousel: parent only).

isPaidPartnershipbooleandefault: false

"Paid partnership" label (Facebook Login only; not Stories).

brandedContentSponsorsarray of string

Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.

≤ 2 items

productTagsarray of object

Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.

Show 4 item attributes
productIdstringrequired
xnumber

0–1

ynumber

0–1

mediaIndexintegerdefault: 0
commentsEnabledbooleandefault: true

false disables comments right after publishing (best-effort; not Stories).

firstCommentstring

Posted as the first comment (not Stories). Also read from post.firstComment.

≤ 2200 characters

uploadTypestringdefault: "url"

resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url.

urlresumable

checkPublishingLimitbooleandefault: false

Read content_publishing_limit first and fail fast when the 24 h quota is used up.

containerIdstring

Publish a container created earlier (≤24 h) instead of creating a new one.

Responses

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

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

Try it with MCPAsk your agent to call instagram-scheduled-update (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
statusstring

draftscheduledpublishingpublishedfailed

contentstring | null

≤ 2200 characters

scheduled_forstring (date-time) | null
mediaarray of object | null

1–10 items

Show 4 item attributes
media_idstring | null
urlstring (uri) | null
typestring | null

imagevideo

alt_textstring | null

≤ 1000 characters

platform_optionsobject | null
Show 21 child attributes
contentTypestringdefault: "auto"

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

autofeedreelstorycarousel

shareToFeedbooleandefault: true

Reels only: also show the Reel in the main feed.

collaboratorsarray of string

Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).

≤ 3 items

userTagsarray of string | object

People tags (feed, Reels, carousel items, Stories).

≤ 20 items

One of 2 shapes

Option 1 string

Username (leading @ stripped). Images default to the centre (0.5, 0.5).

Option 2 object

usernamestringrequired
xnumber

From the left edge. Required for photos (defaults to 0.5), ignored for video.

0–1

ynumber

From the top edge. Required for photos (defaults to 0.5), ignored for video.

0–1

mediaIndexinteger

Carousel slide index.

locationIdstring

Facebook Page id with location data (feed, Reels, carousels; not Stories).

pattern ^[0-9]+$

altTextstring

Fallback alt text for images (per-item media[].altText wins). Images only.

≤ 1000 characters

coverUrlstring (uri)

Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl.

thumbOffsetinteger

Reel cover frame offset in milliseconds.

audioNamestring

Rename the Reel original audio (once, at creation).

audioConfigurationobject

Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).

Show 3 child attributes
audioIdstringrequired
audioVolumeintegerdefault: 100

0–100

videoVolumeintegerdefault: 100

0 mutes the original sound.

0–100

muteAudiobooleandefault: false

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

trialParamsobject

Trial Reel shown to non-followers first (Reels only).

Show 1 child attributes
graduationStrategystringrequired

MANUALSS_PERFORMANCE

isAiGeneratedbooleandefault: false

Meta "AI info" label (carousel: parent only).

isPaidPartnershipbooleandefault: false

"Paid partnership" label (Facebook Login only; not Stories).

brandedContentSponsorsarray of string

Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.

≤ 2 items

productTagsarray of object

Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.

Show 4 item attributes
productIdstringrequired
xnumber

0–1

ynumber

0–1

mediaIndexintegerdefault: 0
commentsEnabledbooleandefault: true

false disables comments right after publishing (best-effort; not Stories).

firstCommentstring

Posted as the first comment (not Stories). Also read from post.firstComment.

≤ 2200 characters

uploadTypestringdefault: "url"

resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url.

urlresumable

checkPublishingLimitbooleandefault: false

Read content_publishing_limit first and fail fast when the 24 h quota is used up.

containerIdstring

Publish a container created earlier (≤24 h) instead of creating a new one.

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/instagram/scheduled/{itemId}
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

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

Try it with MCPAsk your agent to call instagram-scheduled-delete (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Live

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

Try it with MCPAsk your agent to call instagram-live-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring
media_typestring
media_product_typestring
usernamestring | null
timestampstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

Collaboration invites

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

Try it with MCPAsk your agent to call instagram-collaboration-invites-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

afterstring

Cursor from next_cursor

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
media_idstring
media_owner_usernamestring | null
captionstring | null
media_urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-collaboration-invites-accept (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/collaboration-invites/{itemId}/accept
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

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

Try it with MCPAsk your agent to call instagram-collaboration-invites-decline (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/collaboration-invites/{itemId}/decline
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

Collaborative media

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

Try it with MCPAsk your agent to call instagram-collaborative-media-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

afterstring

Cursor from next_cursor

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 21 item attributes
idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

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

Responses

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

Upcoming events

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

Try it with MCPAsk your agent to call instagram-upcoming-events-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstringread-only
titlestring
start_timestring (date-time)
end_timestring (date-time) | null
notification_subtypesarray of string | null
notification_target_timestring | null

EVENT_STARTEVENT_END

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

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-upcoming-events-create (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

titlestring
start_timestring (date-time)
end_timestring (date-time) | null
notification_subtypesarray of string | null
notification_target_timestring | null

EVENT_STARTEVENT_END

Returns object

idstringread-only
titlestring
start_timestring (date-time)
end_timestring (date-time) | null
notification_subtypesarray of string | null
notification_target_timestring | null

EVENT_STARTEVENT_END

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/upcoming-events
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

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

Try it with MCPAsk your agent to call instagram-upcoming-events-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
titlestring
start_timestring (date-time)
end_timestring (date-time) | null
notification_subtypesarray of string | null
notification_target_timestring | null

EVENT_STARTEVENT_END

Responses

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

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

Try it with MCPAsk your agent to call instagram-upcoming-events-update (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring
start_timestring (date-time)
end_timestring (date-time) | null
notification_subtypesarray of string | null
notification_target_timestring | null

EVENT_STARTEVENT_END

Returns object

idstringread-only
titlestring
start_timestring (date-time)
end_timestring (date-time) | null
notification_subtypesarray of string | null
notification_target_timestring | null

EVENT_STARTEVENT_END

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/instagram/upcoming-events/{itemId}
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

Comments

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: readZernio: GET /v1/inbox/comments

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

afterstring

Cursor from next_cursor

media_idstring | null

Only comments on this media

media_limitinteger | nulldefault: 15

Recent media scanned for the queue

1–50

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 12 item attributes
idstringrequiredread-only
textstring
authorstring | null

username

author_idstring | null
created_atstring (date-time)
like_countinteger
hiddenboolean | null
parent_idstring | null
media_idstring | null
replies_countinteger | null
repliesarray of object | null
Show 6 item attributes
idstring
textstring
authorstring | null
created_atstring (date-time)
like_countinteger
hiddenboolean | null
mediaobject | null
Show 5 child attributes
idstring
captionstring | null
permalinkstring (uri) | null
media_product_typestring | null

FEEDREELSSTORYAD

thumbnail_urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}POST /v1/inbox/comments/{postId}/{commentId}/hidePOST /v1/inbox/comments/{postId}/{commentId}/likePOST /v1/inbox/comments/{postId}/{commentId}/private-reply

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

media_idstringrequired
messagestringrequired

≤ 2200 characters

Returns object

idstringrequiredread-only
textstring
authorstring | null

username

author_idstring | null
created_atstring (date-time)
like_countinteger
hiddenboolean | null
parent_idstring | null
media_idstring | null
replies_countinteger | null
repliesarray of object | null
Show 6 item attributes
idstring
textstring
authorstring | null
created_atstring (date-time)
like_countinteger
hiddenboolean | null
mediaobject | null
Show 5 child attributes
idstring
captionstring | null
permalinkstring (uri) | null
media_product_typestring | null

FEEDREELSSTORYAD

thumbnail_urlstring (uri) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/comments
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

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: readZernio: GET /v1/inbox/comments/{postId}

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
textstring
authorstring | null

username

author_idstring | null
created_atstring (date-time)
like_countinteger
hiddenboolean | null
parent_idstring | null
media_idstring | null
replies_countinteger | null
repliesarray of object | null
Show 6 item attributes
idstring
textstring
authorstring | null
created_atstring (date-time)
like_countinteger
hiddenboolean | null
mediaobject | null
Show 5 child attributes
idstring
captionstring | null
permalinkstring (uri) | null
media_product_typestring | null

FEEDREELSSTORYAD

thumbnail_urlstring (uri) | null

Responses

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

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: writeZernio: DELETE /v1/inbox/comments/{postId}DELETE /v1/inbox/comments/{postId}/{commentId}/hideDELETE /v1/inbox/comments/{postId}/{commentId}/like

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

messagestringrequired

≤ 2200 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/comments/{itemId}/reply
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/comments/{itemId}/replies
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/comments/{itemId}/hide
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/comments/{itemId}/unhide
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/comments/{itemId}/like
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/comments/{itemId}/unlike
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

textstring | null

≤1000 bytes; URLs must be valid

≤ 1000 characters

attachmentobject | null
Show 4 child attributes
typestring

imagevideoaudiofile

urlstring (uri) | null
media_idstring | null
attachment_idstring | null

Reusable id from the Attachment Upload API

attachmentsarray of object | null

Multi-image message (≤10 images)

≤ 10 items

Show 2 item attributes
typestring

image

urlstring (uri)
quick_repliesarray of object | null

≤ 13 items

Show 2 item attributes
titlestring

≤ 20 characters

payloadstring | null
buttonsarray of object | null

≤ 3 items

Show 3 item attributes
titlestring
urlstring (uri) | null
payloadstring | null
elementsarray of object | null

Generic template carousel

≤ 10 items

Show 4 item attributes
titlestring
subtitlestring | null
image_urlstring (uri) | null
buttonsarray of object | null
Show 4 item attributes
typestring
titlestring
urlstring (uri) | null
payloadstring | null
stickerstring | null

like_heart

media_share_idstring | null

Own post id to share (MEDIA_SHARE)

reply_tostring | null

Message id to reply to

human_agentboolean | null

Send with the HUMAN_AGENT tag (up to 7 days after the last user message; needs the Human Agent feature)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/comments/{itemId}/private-reply
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

Mentions

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

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

afterstring

Cursor from next_cursor

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 21 item attributes
idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

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

Responses

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

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

Try it with MCPAsk your agent to call instagram-mentions-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

is_ai_generatedboolean | null

Responses

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

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: writeIdempotency-KeyZernio: POST /v1/inbox/mentions/replyPOST /v1/inbox/posts/{postId}/likeDELETE /v1/inbox/posts/{postId}/like

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

comment_idstring | null
messagestringrequired

≤ 2200 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/mentions/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-mentions-mentioned-comment (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

comment_idstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/mentions/mentioned-comment
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-mentions-like (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/mentions/{itemId}/like
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

Conversations

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: readZernio: GET /v1/inbox/conversationsGET /v1/inbox/conversations/{conversationId}/messages

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

afterstring

Cursor from next_cursor

user_idstring | null

IGSID: find the thread with this user

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstring
updated_atstring (date-time)
unread_countinteger
last_messagestring | null
participantsarray of object
Show 3 item attributes
idstring
namestring | null
usernamestring | null
participantobject | null
Show 3 child attributes
idstring
namestring | null
usernamestring | null
messagesarray of object | null
Show 8 item attributes
idstring
textstring | null
directionstring

inout

sent_atstring (date-time)
from_idstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring (uri) | null
reply_tostring | null
story_replyobject | null
Show 2 child attributes
idstring | null
urlstring (uri) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: readZernio: GET /v1/inbox/conversations/{conversationId}

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
updated_atstring (date-time)
unread_countinteger
last_messagestring | null
participantsarray of object
Show 3 item attributes
idstring
namestring | null
usernamestring | null
participantobject | null
Show 3 child attributes
idstring
namestring | null
usernamestring | null
messagesarray of object | null
Show 8 item attributes
idstring
textstring | null
directionstring

inout

sent_atstring (date-time)
from_idstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring (uri) | null
reply_tostring | null
story_replyobject | null
Show 2 child attributes
idstring | null
urlstring (uri) | null

Responses

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

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: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/messagesPOST /v1/inbox/conversations/{conversationId}/typingPOST /v1/inbox/conversations/{conversationId}/readPOST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactionsDELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

recipient_idstring | null
textstring | null

≤1000 bytes; URLs must be valid

≤ 1000 characters

attachmentobject | null
Show 4 child attributes
typestring

imagevideoaudiofile

urlstring (uri) | null
media_idstring | null
attachment_idstring | null

Reusable id from the Attachment Upload API

attachmentsarray of object | null

Multi-image message (≤10 images)

≤ 10 items

Show 2 item attributes
typestring

image

urlstring (uri)
quick_repliesarray of object | null

≤ 13 items

Show 2 item attributes
titlestring

≤ 20 characters

payloadstring | null
buttonsarray of object | null

≤ 3 items

Show 3 item attributes
titlestring
urlstring (uri) | null
payloadstring | null
elementsarray of object | null

Generic template carousel

≤ 10 items

Show 4 item attributes
titlestring
subtitlestring | null
image_urlstring (uri) | null
buttonsarray of object | null
Show 4 item attributes
typestring
titlestring
urlstring (uri) | null
payloadstring | null
stickerstring | null

like_heart

media_share_idstring | null

Own post id to share (MEDIA_SHARE)

reply_tostring | null

Message id to reply to

human_agentboolean | null

Send with the HUMAN_AGENT tag (up to 7 days after the last user message; needs the Human Agent feature)

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/conversations/{itemId}/send
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

message_idstringrequired
reactionstring | nulldefault: "love"

Emoji or "love"

recipient_idstring | null

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/conversations/{itemId}/react
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

message_idstringrequired
recipient_idstring | null

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/conversations/{itemId}/unreact
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

onboolean | nulldefault: true
recipient_idstring | null

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/conversations/{itemId}/typing
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

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: writeIdempotency-Key

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

recipient_idstring | null

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/conversations/{itemId}/mark-seen
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

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

Try it with MCPAsk your agent to call instagram-conversations-block (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

recipient_idstring | null

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/conversations/{itemId}/block
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-conversations-unblock (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

recipient_idstring | null

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/conversations/{itemId}/unblock
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

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

Try it with MCPAsk your agent to call instagram-conversations-spam (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

recipient_idstring | null

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/conversations/{itemId}/spam
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

Ice breakers

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: readZernio: GET /v1/accounts/{accountId}/instagram-ice-breakers

Try it with MCPAsk your agent to call instagram-ice-breakers-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

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

≤ 4 items

Show 2 item attributes
questionstringrequired

≤ 80 characters

payloadstring | null

Responses

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

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: writeZernio: PUT /v1/accounts/{accountId}/instagram-ice-breakers

Try it with MCPAsk your agent to call instagram-ice-breakers-update (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

ice_breakersarray of object
Show 2 item attributes
localestring | null
call_to_actionsarray of object

≤ 4 items

Show 2 item attributes
questionstringrequired

≤ 80 characters

payloadstring | null
questionsarray of object | null

≤ 4 items

Show 2 item attributes
questionstringrequired

≤ 80 characters

payloadstring | null

Returns object

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

≤ 4 items

Show 2 item attributes
questionstringrequired

≤ 80 characters

payloadstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/instagram/ice-breakers
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

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: writeZernio: DELETE /v1/accounts/{accountId}/instagram-ice-breakers

Try it with MCPAsk your agent to call instagram-ice-breakers-delete (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

Persistent menu

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: readZernio: GET /v1/accounts/{accountId}/messenger-menu

Try it with MCPAsk your agent to call instagram-persistent-menu-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

persistent_menuarray of object
Show 3 item attributes
localestringdefault: "default"
composer_input_disabledboolean | null
call_to_actionsarray of object
Show 3 item attributes
titlestringrequired
urlstring (uri) | null
payloadstring | null

Responses

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

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: writeZernio: PUT /v1/accounts/{accountId}/messenger-menu

Try it with MCPAsk your agent to call instagram-persistent-menu-update (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

persistent_menuarray of object
Show 3 item attributes
localestringdefault: "default"
composer_input_disabledboolean | null
call_to_actionsarray of object
Show 3 item attributes
titlestringrequired
urlstring (uri) | null
payloadstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/instagram/persistent-menu
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

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: writeZernio: DELETE /v1/accounts/{accountId}/messenger-menu

Try it with MCPAsk your agent to call instagram-persistent-menu-delete (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

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

People

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: readZernio: GET /v1/accounts/{accountId}/follow-status/{userId}

Try it with MCPAsk your agent to call instagram-people-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

user_idstring
usernamestring | null
namestring | null
is_followerboolean | null
is_followed_by_accountboolean | null
follower_countinteger | null
is_verifiedboolean | null
unavailable_reasonstring | null

consent_requireddm_access_disablednot_messageableerror

Responses

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

Message attachments

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-message-attachments-create (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

typestring

imagevideoaudiofile

urlstring (uri)required

Returns object

attachment_idstring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/message-attachments
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

Account insights

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: readZernio: GET /v1/analytics/instagram/account-insights

Try it with MCPAsk your agent to call instagram-account-insights-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date-time) | null
untilstring (date-time) | null
metricsarray of string | null
metric_typestring | nulldefault: "total_value"

total_valuetime_series

breakdownstring | null

media_product_typefollow_typecontact_button_type

Returns object

date_rangeobject
Show 2 child attributes
sincestring
untilstring
metric_typestring

total_valuetime_series

breakdownstring | null
metricsmap of object
unavailable_metricsarray of object
Show 2 item attributes
metricstring
reasonstring

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-account-insights-summary (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

sincestring (date-time) | null
untilstring (date-time) | null

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/account-insights/summary
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

Content insights

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

Try it with MCPAsk your agent to call instagram-content-insights-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date-time) | null
untilstring (date-time) | null
limitinteger | nulldefault: 25

≤ 50

metricstring | null

viewsreachlikescommentssharessavesengagementsengagement_rate

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 16 item attributes
idstring
captionstring | null
media_product_typestring | null
permalinkstring (uri) | null
thumbnail_urlstring (uri) | null
timestampstring (date-time)
viewsnumber | null
reachnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
engagementsnumber | null
engagement_ratenumber | null
watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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

Try it with MCPAsk your agent to call instagram-content-insights-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
captionstring | null
media_product_typestring | null
permalinkstring (uri) | null
thumbnail_urlstring (uri) | null
timestampstring (date-time)
viewsnumber | null
reachnumber | null
likesnumber | null
commentsnumber | null
sharesnumber | null
savesnumber | null
engagementsnumber | null
engagement_ratenumber | null
watch_time_secondsnumber | null
avg_view_duration_secondsnumber | null

Responses

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

Audience

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: readZernio: GET /v1/analytics/instagram/demographics

Try it with MCPAsk your agent to call instagram-audience-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

metricstring | nulldefault: "follower_demographics"

follower_demographicsengaged_audience_demographics

timeframestring | nulldefault: "this_month"

this_weekthis_monthprev_monthlast_14_dayslast_30_dayslast_90_days

breakdownarray of string | null

Returns object

metricstring

follower_demographicsengaged_audience_demographics

timeframestring

this_weekthis_monthprev_monthlast_14_dayslast_30_dayslast_90_days

demographicsobject
Show 4 child attributes
agearray of object
Show 2 item attributes
keystring
valuenumber
genderarray of object
Show 2 item attributes
keystring
valuenumber
countryarray of object
Show 2 item attributes
keystring
valuenumber
cityarray of object
Show 2 item attributes
keystring
valuenumber

Responses

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

Online followers

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: readZernio: GET /v1/analytics/instagram/online-followers

Try it with MCPAsk your agent to call instagram-online-followers-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

daysarray of object
Show 2 item attributes
datestring
hoursmap of number
average_by_hourarray of object
Show 2 item attributes
hourinteger

0–23

valuenumber
best_hoursarray of integer

Responses

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

Follower history

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: readZernio: GET /v1/analytics/instagram/follower-history

Try it with MCPAsk your agent to call instagram-follower-history-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date-time) | null
untilstring (date-time) | null

Returns object

current_followersinteger | null
metricsobject
Show 3 child attributes
follower_countarray of object
Show 2 item attributes
datestring (date)
valuenumber
followers_gainedarray of object
Show 2 item attributes
datestring (date)
valuenumber
followers_lostarray of object
Show 2 item attributes
datestring (date)
valuenumber

Responses

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

Hashtags

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

Try it with MCPAsk your agent to call instagram-hashtags-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
idstring
namestring
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-hashtags-create (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

qstringrequired

Hashtag without #

Returns object

idstring
namestring

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/hashtags
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

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

Try it with MCPAsk your agent to call instagram-hashtags-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstring
namestring

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-hashtags-top-media (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

limitintegerdefault: 25

1–100

afterstring

Cursor from next_cursor

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/hashtags/{itemId}/top-media
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-hashtags-recent-media (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

limitintegerdefault: 25

1–100

afterstring

Cursor from next_cursor

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/hashtags/{itemId}/recent-media
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

Business discovery

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: readZernio: GET /v1/accounts/{accountId}/instagram/business-discovery

Try it with MCPAsk your agent to call instagram-business-discovery-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Query parameters

limitinteger | nulldefault: 12

≤ 50

afterstring | null

Returns object

profileobject
Show 9 child attributes
idstring
usernamestring
namestring | null
biographystring | null
websitestring (uri) | null
profile_picture_urlstring (uri) | null
followers_countinteger | null
follows_countinteger | null
media_countinteger | null
mediaarray of object
Show 22 item attributes
idstringrequiredread-only
captionstring | null

≤ 2200 characters

media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_product_typestring

FEEDREELSSTORYAD

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
permalinkstring (uri) | null
shortcodestring | null
timestampstring (date-time)
usernamestring | null
like_countinteger | null
comments_countinteger | null
is_comment_enabledboolean | null
is_shared_to_feedboolean | null
alt_textstring | null
childrenarray of object | null
Show 4 item attributes
idstring
media_typestring

IMAGEVIDEOCAROUSEL_ALBUM

media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
reposts_countinteger | null

Facebook Login only

saved_countinteger | null

Facebook Login only

shares_countinteger | null

Facebook Login only

media_audio_typestring | null

MUSICORIGINAL_SOUND

is_ai_generatedboolean | null
view_countinteger | null
next_cursorstring | null

Responses

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

Oembed

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-oembed-create (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

urlstring (uri)required
maxwidthinteger | null
hidecaptionboolean | null
omitscriptboolean | null

Returns object

htmlstring
provider_namestring | null
widthinteger | null
typestring | null
versionstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/oembed
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

Catalogs

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

Try it with MCPAsk your agent to call instagram-catalogs-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
catalog_idstring
catalog_namestring | null
shop_namestring | null
product_countinteger | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

Catalog products

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

Try it with MCPAsk your agent to call instagram-catalog-products-list (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

afterstring

Cursor from next_cursor

catalog_idstring
qstring | null

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
product_idstring
merchant_idstring | null
product_namestring | null
image_urlstring (uri) | null
retailer_idstring | null
review_statusstring | null
is_checkout_flowboolean | null
product_variantsarray of object | null
Show 2 item attributes
product_idstring
variant_namestring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call instagram-catalog-products-appeal (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

appeal_reasonstring | null

Omit to read the appeal status

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/catalog-products/{itemId}/appeal
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

Product tags

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

Try it with MCPAsk your agent to call instagram-product-tags-get (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

media_idstring
tagsarray of object
Show 5 item attributes
product_idstring
namestring | null
xnumber | null
ynumber | null
review_statusstring | null

Responses

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

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

Try it with MCPAsk your agent to call instagram-product-tags-update (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

tagsarray of objectrequired

≤ 5 items

Show 3 item attributes
product_idstringrequired
xnumber | null

0–1

ynumber | null

0–1

Returns object

media_idstring
tagsarray of object
Show 5 item attributes
product_idstring
namestring | null
xnumber | null
ynumber | null
review_statusstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/instagram/product-tags/{itemId}
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

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

Try it with MCPAsk your agent to call instagram-product-tags-remove (toolset focus_instagram)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

product_idsarray of stringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

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

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/instagram/product-tags/{itemId}/remove
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