Focus · Instagram
Typed Focus mode operations for Instagram accounts, generated from the Instagram focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_instagram- Stories3
- Profile1
- Webhook subscriptions3
- Media13
- Reels12
- Containers3
- Scheduled5
- Live1
- Collaboration invites3
- Collaborative media1
- Upcoming events4
- Comments11
- Mentions5
- Conversations10
- Ice breakers3
- Persistent menu3
- People1
- Message attachments1
- Account insights2
- Content insights2
- Audience1
- Online followers1
- Follower history1
- Hashtags5
- Business discovery1
- Oembed1
- Catalogs1
- Catalog products2
- Product tags3
Stories
Instagram: Create a Stories item
/accounts/{accountId}/instagram/storiesPublish 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.
Try it with MCPAsk your agent to call instagram-stories-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediaarray of objectrequired1–10 items
Show 4 item attributes
media_idstring | nullurlstring (uri) | nulltypestring | nullimagevideo
alt_textstring | null≤ 1000 characters
user_tagsarray of object | nullShow 4 item attributes
usernamestringxnumber | nullynumber | nullmedia_indexinteger | nullReturns object
idstringmedia_typestringIMAGEVIDEO
media_product_typestringSTORY
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nulltimestampstring (date-time)usernamestring | nullResponses
Instagram: Delete a Stories item
/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.
Try it with MCPAsk your agent to call instagram-stories-delete (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Instagram: Story insights (Stories)
/accounts/{accountId}/instagram/stories/{itemId}/insightsviews, 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.
Try it with MCPAsk your agent to call instagram-stories-insights (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Profile
Instagram: Get Profile
/accounts/{accountId}/instagram/profileBio, 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.
Try it with MCPAsk your agent to call instagram-profile-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringread-onlyusernamestringread-onlynamestring | nullread-onlybiographystring | nullread-onlywebsitestring (uri) | nullread-onlyprofile_picture_urlstring (uri) | nullread-onlyfollowers_countinteger | nullread-onlyfollows_countinteger | nullread-onlymedia_countinteger | nullread-onlyaccount_typestring | nullread-onlyBUSINESSMEDIA_CREATOR
login_typestringread-onlyinstagram_loginfacebook_login
page_idstring | nullread-onlyLinked Facebook Page (Facebook Login)
shopping_product_tag_eligibilityboolean | nullread-onlyprofile_urlstring (uri) | nullread-onlyeditablebooleanread-onlyResponses
Webhook subscriptions
Instagram: List Webhook subscriptions
/accounts/{accountId}/instagram/webhook-subscriptionsReal-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.
Try it with MCPAsk your agent to call instagram-webhook-subscriptions-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstring | nullnamestring | nullsubscribed_fieldsarray of stringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Create a Webhook subscriptions item
/accounts/{accountId}/instagram/webhook-subscriptionsReal-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.
Try it with MCPAsk your agent to call instagram-webhook-subscriptions-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
fieldsarray of string | nullDefaults to every supported field
Returns object
idstring | nullnamestring | nullsubscribed_fieldsarray of stringResponses
Instagram: Unsubscribe (Webhook subscriptions)
/accounts/{accountId}/instagram/webhook-subscriptions/unsubscribeUnsubscribe. 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.
Try it with MCPAsk your agent to call instagram-webhook-subscriptions-unsubscribe (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Media
Instagram: List Posts
/accounts/{accountId}/instagram/mediaFeed 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.
Try it with MCPAsk your agent to call instagram-media-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
afterstringCursor from next_cursor
sincestring (date-time) | nulluntilstring (date-time) | nullmedia_typestring | nullIMAGEVIDEOCAROUSEL_ALBUM
product_typestring | nullFEEDREELS
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 21 item attributes
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Create a Posts item
/accounts/{accountId}/instagram/mediaPublish 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.
Try it with MCPAsk your agent to call instagram-media-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
captionstring | null≤2,200 chars, ≤30 hashtags, ≤20 @mentions. Ignored for Stories.
≤ 2200 characters
mediaarray of objectrequired1–10 items
Show 4 item attributes
media_idstring | nullurlstring (uri) | nulltypestring | nullimagevideo
alt_textstring | null≤ 1000 characters
optionsobjectShow 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: trueReels only: also show the Reel in the main feed.
collaboratorsarray of stringUp to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).
≤ 3 items
userTagsarray of string | objectPeople 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
usernamestringrequiredxnumberFrom the left edge. Required for photos (defaults to 0.5), ignored for video.
0–1
ynumberFrom the top edge. Required for photos (defaults to 0.5), ignored for video.
0–1
mediaIndexintegerCarousel slide index.
locationIdstringFacebook Page id with location data (feed, Reels, carousels; not Stories).
pattern ^[0-9]+$
altTextstringFallback 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.
thumbOffsetintegerReel cover frame offset in milliseconds.
audioNamestringRename the Reel original audio (once, at creation).
audioConfigurationobjectCatalog / original-sound track from the Audio API (Reels only; Facebook Login only).
Show 3 child attributes
audioIdstringrequiredaudioVolumeintegerdefault: 1000–100
videoVolumeintegerdefault: 1000 mutes the original sound.
0–100
muteAudiobooleandefault: falseSilence 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).
trialParamsobjectTrial Reel shown to non-followers first (Reels only).
Show 1 child attributes
graduationStrategystringrequiredMANUALSS_PERFORMANCE
isAiGeneratedbooleandefault: falseMeta "AI info" label (carousel: parent only).
isPaidPartnershipbooleandefault: false"Paid partnership" label (Facebook Login only; not Stories).
brandedContentSponsorsarray of stringUp to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.
≤ 2 items
productTagsarray of objectCatalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.
Show 4 item attributes
productIdstringrequiredxnumber0–1
ynumber0–1
mediaIndexintegerdefault: 0commentsEnabledbooleandefault: truefalse disables comments right after publishing (best-effort; not Stories).
firstCommentstringPosted 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: falseRead content_publishing_limit first and fail fast when the 24 h quota is used up.
containerIdstringPublish a container created earlier (≤24 h) instead of creating a new one.
first_commentstring | null≤ 2200 characters
Returns object
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nullResponses
Instagram: Get a Posts item
/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.
Try it with MCPAsk your agent to call instagram-media-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nullResponses
Instagram: Update a Posts item
/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.
Try it with MCPAsk your agent to call instagram-media-update (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
comments_enabledbooleanReturns object
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nullResponses
Instagram: Delete a Posts item
/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.
Try it with MCPAsk your agent to call instagram-media-delete (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Instagram: Enable comments (Posts)
/accounts/{accountId}/instagram/media/{itemId}/enable-commentsEnable 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.
Try it with MCPAsk your agent to call instagram-media-enable-comments (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Disable comments (Posts)
/accounts/{accountId}/instagram/media/{itemId}/disable-commentsDisable 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.
Try it with MCPAsk your agent to call instagram-media-disable-comments (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Add comment (Posts)
/accounts/{accountId}/instagram/media/{itemId}/commentAdd 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.
Try it with MCPAsk your agent to call instagram-media-comment (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≤ 2200 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Insights (Posts)
/accounts/{accountId}/instagram/media/{itemId}/insightsPer-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.
Try it with MCPAsk your agent to call instagram-media-insights (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Carousel items (Posts)
/accounts/{accountId}/instagram/media/{itemId}/childrenCarousel 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.
Try it with MCPAsk your agent to call instagram-media-children (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Collaborators (Posts)
/accounts/{accountId}/instagram/media/{itemId}/collaboratorsCollaborators. 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.
Try it with MCPAsk your agent to call instagram-media-collaborators (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Like as business (Posts)
/accounts/{accountId}/instagram/media/{itemId}/likeLike 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.
Try it with MCPAsk your agent to call instagram-media-like (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Unlike (Posts)
/accounts/{accountId}/instagram/media/{itemId}/unlikeUnlike. 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.
Try it with MCPAsk your agent to call instagram-media-unlike (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reels
Instagram: List Reels
/accounts/{accountId}/instagram/reelsReels 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.
Try it with MCPAsk your agent to call instagram-reels-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
afterstringCursor from next_cursor
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 21 item attributes
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Create a Reels item
/accounts/{accountId}/instagram/reelsReels 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.
Try it with MCPAsk your agent to call instagram-reels-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
captionstring | null≤ 2200 characters
videoobjectrequiredShow 2 child attributes
media_idstring | nullurlstring (uri) | nullshare_to_feedboolean | nulldefault: truecover_urlstring (uri) | nullthumb_offsetinteger | nullaudio_namestring | nullaudio_idstring | nullAudio API track (Facebook Login)
trialstring | nullPublish as a trial Reel
MANUALSS_PERFORMANCE
collaboratorsarray of string | null≤ 3 items
location_idstring | nullfirst_commentstring | nullReturns object
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nullResponses
Instagram: Get a Reels item
/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.
Try it with MCPAsk your agent to call instagram-reels-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nullResponses
Instagram: Delete a Reels item
/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.
Try it with MCPAsk your agent to call instagram-reels-delete (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Instagram: Enable comments (Reels)
/accounts/{accountId}/instagram/reels/{itemId}/enable-commentsEnable 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.
Try it with MCPAsk your agent to call instagram-reels-enable-comments (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Disable comments (Reels)
/accounts/{accountId}/instagram/reels/{itemId}/disable-commentsDisable 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.
Try it with MCPAsk your agent to call instagram-reels-disable-comments (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Add comment (Reels)
/accounts/{accountId}/instagram/reels/{itemId}/commentAdd 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.
Try it with MCPAsk your agent to call instagram-reels-comment (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≤ 2200 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Insights (Reels)
/accounts/{accountId}/instagram/reels/{itemId}/insightsPer-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.
Try it with MCPAsk your agent to call instagram-reels-insights (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Carousel items (Reels)
/accounts/{accountId}/instagram/reels/{itemId}/childrenCarousel 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.
Try it with MCPAsk your agent to call instagram-reels-children (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Collaborators (Reels)
/accounts/{accountId}/instagram/reels/{itemId}/collaboratorsCollaborators. 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.
Try it with MCPAsk your agent to call instagram-reels-collaborators (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Like as business (Reels)
/accounts/{accountId}/instagram/reels/{itemId}/likeLike 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.
Try it with MCPAsk your agent to call instagram-reels-like (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Unlike (Reels)
/accounts/{accountId}/instagram/reels/{itemId}/unlikeUnlike. 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.
Try it with MCPAsk your agent to call instagram-reels-unlike (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Containers
Instagram: Get a Media containers item
/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.
Try it with MCPAsk your agent to call instagram-containers-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringstatus_codestring | nullIN_PROGRESSFINISHEDERROREXPIREDPUBLISHED
statusstring | nullResponses
Instagram: Create a Media containers item
/accounts/{accountId}/instagram/containersCreate 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.
Try it with MCPAsk your agent to call instagram-containers-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
image_urlstring (uri) | nullvideo_urlstring (uri) | nullmedia_typestring | nullREELSSTORIESCAROUSELVIDEO
captionstring | nullis_carousel_itemboolean | nullchildrenarray of string | nullshare_to_feedboolean | nullcover_urlstring (uri) | nullthumb_offsetinteger | nulllocation_idstring | nullalt_textstring | nullcollaboratorsarray of string | nulluser_tagsarray of object | nullShow 3 item attributes
usernamestringxnumber | nullynumber | nullReturns object
idstringstatus_codestring | nullIN_PROGRESSFINISHEDERROREXPIREDPUBLISHED
statusstring | nullResponses
Instagram: Publish container (Media containers)
/accounts/{accountId}/instagram/containers/{itemId}/publishPublish 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.
Try it with MCPAsk your agent to call instagram-containers-publish (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Scheduled
Instagram: List Scheduled & drafts
/accounts/{accountId}/instagram/scheduledPosts 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.
Try it with MCPAsk your agent to call instagram-scheduled-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
statusstring | nulldraftscheduledfailed
fromstring (date-time) | nulltostring (date-time) | nullReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlystatusstringdraftscheduledpublishingpublishedfailed
contentstring | null≤ 2200 characters
scheduled_forstring (date-time) | nullmediaarray of object | null1–10 items
Show 4 item attributes
media_idstring | nullurlstring (uri) | nulltypestring | nullimagevideo
alt_textstring | null≤ 1000 characters
platform_optionsobject | nullShow 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: trueReels only: also show the Reel in the main feed.
collaboratorsarray of stringUp to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).
≤ 3 items
userTagsarray of string | objectPeople 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
usernamestringrequiredxnumberFrom the left edge. Required for photos (defaults to 0.5), ignored for video.
0–1
ynumberFrom the top edge. Required for photos (defaults to 0.5), ignored for video.
0–1
mediaIndexintegerCarousel slide index.
locationIdstringFacebook Page id with location data (feed, Reels, carousels; not Stories).
pattern ^[0-9]+$
altTextstringFallback 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.
thumbOffsetintegerReel cover frame offset in milliseconds.
audioNamestringRename the Reel original audio (once, at creation).
audioConfigurationobjectCatalog / original-sound track from the Audio API (Reels only; Facebook Login only).
Show 3 child attributes
audioIdstringrequiredaudioVolumeintegerdefault: 1000–100
videoVolumeintegerdefault: 1000 mutes the original sound.
0–100
muteAudiobooleandefault: falseSilence 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).
trialParamsobjectTrial Reel shown to non-followers first (Reels only).
Show 1 child attributes
graduationStrategystringrequiredMANUALSS_PERFORMANCE
isAiGeneratedbooleandefault: falseMeta "AI info" label (carousel: parent only).
isPaidPartnershipbooleandefault: false"Paid partnership" label (Facebook Login only; not Stories).
brandedContentSponsorsarray of stringUp to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.
≤ 2 items
productTagsarray of objectCatalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.
Show 4 item attributes
productIdstringrequiredxnumber0–1
ynumber0–1
mediaIndexintegerdefault: 0commentsEnabledbooleandefault: truefalse disables comments right after publishing (best-effort; not Stories).
firstCommentstringPosted 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: falseRead content_publishing_limit first and fail fast when the 24 h quota is used up.
containerIdstringPublish a container created earlier (≤24 h) instead of creating a new one.
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Create a Scheduled & drafts item
/accounts/{accountId}/instagram/scheduledPosts 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.
Try it with MCPAsk your agent to call instagram-scheduled-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
contentstring | nullscheduled_forstring (date-time) | nullstatusstring | nulldraftscheduled
mediaarray of object | null1–10 items
Show 4 item attributes
media_idstring | nullurlstring (uri) | nulltypestring | nullimagevideo
alt_textstring | null≤ 1000 characters
platform_optionsobject | nullReturns object
idstringread-onlystatusstringdraftscheduledpublishingpublishedfailed
contentstring | null≤ 2200 characters
scheduled_forstring (date-time) | nullmediaarray of object | null1–10 items
Show 4 item attributes
media_idstring | nullurlstring (uri) | nulltypestring | nullimagevideo
alt_textstring | null≤ 1000 characters
platform_optionsobject | nullShow 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: trueReels only: also show the Reel in the main feed.
collaboratorsarray of stringUp to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).
≤ 3 items
userTagsarray of string | objectPeople 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
usernamestringrequiredxnumberFrom the left edge. Required for photos (defaults to 0.5), ignored for video.
0–1
ynumberFrom the top edge. Required for photos (defaults to 0.5), ignored for video.
0–1
mediaIndexintegerCarousel slide index.
locationIdstringFacebook Page id with location data (feed, Reels, carousels; not Stories).
pattern ^[0-9]+$
altTextstringFallback 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.
thumbOffsetintegerReel cover frame offset in milliseconds.
audioNamestringRename the Reel original audio (once, at creation).
audioConfigurationobjectCatalog / original-sound track from the Audio API (Reels only; Facebook Login only).
Show 3 child attributes
audioIdstringrequiredaudioVolumeintegerdefault: 1000–100
videoVolumeintegerdefault: 1000 mutes the original sound.
0–100
muteAudiobooleandefault: falseSilence 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).
trialParamsobjectTrial Reel shown to non-followers first (Reels only).
Show 1 child attributes
graduationStrategystringrequiredMANUALSS_PERFORMANCE
isAiGeneratedbooleandefault: falseMeta "AI info" label (carousel: parent only).
isPaidPartnershipbooleandefault: false"Paid partnership" label (Facebook Login only; not Stories).
brandedContentSponsorsarray of stringUp to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.
≤ 2 items
productTagsarray of objectCatalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.
Show 4 item attributes
productIdstringrequiredxnumber0–1
ynumber0–1
mediaIndexintegerdefault: 0commentsEnabledbooleandefault: truefalse disables comments right after publishing (best-effort; not Stories).
firstCommentstringPosted 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: falseRead content_publishing_limit first and fail fast when the 24 h quota is used up.
containerIdstringPublish a container created earlier (≤24 h) instead of creating a new one.
Responses
Instagram: Get a Scheduled & drafts item
/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.
Try it with MCPAsk your agent to call instagram-scheduled-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlystatusstringdraftscheduledpublishingpublishedfailed
contentstring | null≤ 2200 characters
scheduled_forstring (date-time) | nullmediaarray of object | null1–10 items
Show 4 item attributes
media_idstring | nullurlstring (uri) | nulltypestring | nullimagevideo
alt_textstring | null≤ 1000 characters
platform_optionsobject | nullShow 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: trueReels only: also show the Reel in the main feed.
collaboratorsarray of stringUp to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).
≤ 3 items
userTagsarray of string | objectPeople 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
usernamestringrequiredxnumberFrom the left edge. Required for photos (defaults to 0.5), ignored for video.
0–1
ynumberFrom the top edge. Required for photos (defaults to 0.5), ignored for video.
0–1
mediaIndexintegerCarousel slide index.
locationIdstringFacebook Page id with location data (feed, Reels, carousels; not Stories).
pattern ^[0-9]+$
altTextstringFallback 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.
thumbOffsetintegerReel cover frame offset in milliseconds.
audioNamestringRename the Reel original audio (once, at creation).
audioConfigurationobjectCatalog / original-sound track from the Audio API (Reels only; Facebook Login only).
Show 3 child attributes
audioIdstringrequiredaudioVolumeintegerdefault: 1000–100
videoVolumeintegerdefault: 1000 mutes the original sound.
0–100
muteAudiobooleandefault: falseSilence 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).
trialParamsobjectTrial Reel shown to non-followers first (Reels only).
Show 1 child attributes
graduationStrategystringrequiredMANUALSS_PERFORMANCE
isAiGeneratedbooleandefault: falseMeta "AI info" label (carousel: parent only).
isPaidPartnershipbooleandefault: false"Paid partnership" label (Facebook Login only; not Stories).
brandedContentSponsorsarray of stringUp to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.
≤ 2 items
productTagsarray of objectCatalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.
Show 4 item attributes
productIdstringrequiredxnumber0–1
ynumber0–1
mediaIndexintegerdefault: 0commentsEnabledbooleandefault: truefalse disables comments right after publishing (best-effort; not Stories).
firstCommentstringPosted 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: falseRead content_publishing_limit first and fail fast when the 24 h quota is used up.
containerIdstringPublish a container created earlier (≤24 h) instead of creating a new one.
Responses
Instagram: Update a Scheduled & drafts item
/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.
Try it with MCPAsk your agent to call instagram-scheduled-update (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlystatusstringdraftscheduledpublishingpublishedfailed
contentstring | null≤ 2200 characters
scheduled_forstring (date-time) | nullmediaarray of object | null1–10 items
Show 4 item attributes
media_idstring | nullurlstring (uri) | nulltypestring | nullimagevideo
alt_textstring | null≤ 1000 characters
platform_optionsobject | nullShow 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: trueReels only: also show the Reel in the main feed.
collaboratorsarray of stringUp to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories).
≤ 3 items
userTagsarray of string | objectPeople 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
usernamestringrequiredxnumberFrom the left edge. Required for photos (defaults to 0.5), ignored for video.
0–1
ynumberFrom the top edge. Required for photos (defaults to 0.5), ignored for video.
0–1
mediaIndexintegerCarousel slide index.
locationIdstringFacebook Page id with location data (feed, Reels, carousels; not Stories).
pattern ^[0-9]+$
altTextstringFallback 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.
thumbOffsetintegerReel cover frame offset in milliseconds.
audioNamestringRename the Reel original audio (once, at creation).
audioConfigurationobjectCatalog / original-sound track from the Audio API (Reels only; Facebook Login only).
Show 3 child attributes
audioIdstringrequiredaudioVolumeintegerdefault: 1000–100
videoVolumeintegerdefault: 1000 mutes the original sound.
0–100
muteAudiobooleandefault: falseSilence 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).
trialParamsobjectTrial Reel shown to non-followers first (Reels only).
Show 1 child attributes
graduationStrategystringrequiredMANUALSS_PERFORMANCE
isAiGeneratedbooleandefault: falseMeta "AI info" label (carousel: parent only).
isPaidPartnershipbooleandefault: false"Paid partnership" label (Facebook Login only; not Stories).
brandedContentSponsorsarray of stringUp to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery.
≤ 2 items
productTagsarray of objectCatalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.
Show 4 item attributes
productIdstringrequiredxnumber0–1
ynumber0–1
mediaIndexintegerdefault: 0commentsEnabledbooleandefault: truefalse disables comments right after publishing (best-effort; not Stories).
firstCommentstringPosted 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: falseRead content_publishing_limit first and fail fast when the 24 h quota is used up.
containerIdstringPublish a container created earlier (≤24 h) instead of creating a new one.
Responses
Instagram: Delete a Scheduled & drafts item
/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.
Try it with MCPAsk your agent to call instagram-scheduled-delete (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Live
Instagram: List Live
/accounts/{accountId}/instagram/liveLive 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.
Try it with MCPAsk your agent to call instagram-live-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringmedia_typestringmedia_product_typestringusernamestring | nulltimestampstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Collaboration invites
Instagram: List Collab invites
/accounts/{accountId}/instagram/collaboration-invitesPending 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.
Try it with MCPAsk your agent to call instagram-collaboration-invites-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
afterstringCursor from next_cursor
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
media_idstringmedia_owner_usernamestring | nullcaptionstring | nullmedia_urlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Accept (Collab invites)
/accounts/{accountId}/instagram/collaboration-invites/{itemId}/acceptAccept. 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.
Try it with MCPAsk your agent to call instagram-collaboration-invites-accept (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Decline (Collab invites)
/accounts/{accountId}/instagram/collaboration-invites/{itemId}/declineDecline. 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.
Try it with MCPAsk your agent to call instagram-collaboration-invites-decline (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Collaborative media
Instagram: List Collab posts
/accounts/{accountId}/instagram/collaborative-mediaCursor 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.
Try it with MCPAsk your agent to call instagram-collaborative-media-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
afterstringCursor from next_cursor
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 21 item attributes
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Upcoming events
Instagram: List Event reminders
/accounts/{accountId}/instagram/upcoming-eventsUpcoming 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.
Try it with MCPAsk your agent to call instagram-upcoming-events-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlytitlestringstart_timestring (date-time)end_timestring (date-time) | nullnotification_subtypesarray of string | nullnotification_target_timestring | nullEVENT_STARTEVENT_END
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Create a Event reminders item
/accounts/{accountId}/instagram/upcoming-eventsUpcoming 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.
Try it with MCPAsk your agent to call instagram-upcoming-events-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringstart_timestring (date-time)end_timestring (date-time) | nullnotification_subtypesarray of string | nullnotification_target_timestring | nullEVENT_STARTEVENT_END
Returns object
idstringread-onlytitlestringstart_timestring (date-time)end_timestring (date-time) | nullnotification_subtypesarray of string | nullnotification_target_timestring | nullEVENT_STARTEVENT_END
Responses
Instagram: Get a Event reminders item
/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.
Try it with MCPAsk your agent to call instagram-upcoming-events-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestringstart_timestring (date-time)end_timestring (date-time) | nullnotification_subtypesarray of string | nullnotification_target_timestring | nullEVENT_STARTEVENT_END
Responses
Instagram: Update a Event reminders item
/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.
Try it with MCPAsk your agent to call instagram-upcoming-events-update (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestringstart_timestring (date-time)end_timestring (date-time) | nullnotification_subtypesarray of string | nullnotification_target_timestring | nullEVENT_STARTEVENT_END
Returns object
idstringread-onlytitlestringstart_timestring (date-time)end_timestring (date-time) | nullnotification_subtypesarray of string | nullnotification_target_timestring | nullEVENT_STARTEVENT_END
Responses
Comments
Instagram: List Comments
/accounts/{accountId}/instagram/commentsModeration 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.
Try it with MCPAsk your agent to call instagram-comments-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
afterstringCursor from next_cursor
media_idstring | nullOnly comments on this media
media_limitinteger | nulldefault: 15Recent media scanned for the queue
1–50
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringrequiredread-onlytextstringauthorstring | nullusername
author_idstring | nullcreated_atstring (date-time)like_countintegerhiddenboolean | nullparent_idstring | nullmedia_idstring | nullreplies_countinteger | nullrepliesarray of object | nullShow 6 item attributes
idstringtextstringauthorstring | nullcreated_atstring (date-time)like_countintegerhiddenboolean | nullmediaobject | nullShow 5 child attributes
idstringcaptionstring | nullpermalinkstring (uri) | nullmedia_product_typestring | nullFEEDREELSSTORYAD
thumbnail_urlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Create a Comments item
/accounts/{accountId}/instagram/commentsTop-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.
Try it with MCPAsk your agent to call instagram-comments-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
media_idstringrequiredmessagestringrequired≤ 2200 characters
Returns object
idstringrequiredread-onlytextstringauthorstring | nullusername
author_idstring | nullcreated_atstring (date-time)like_countintegerhiddenboolean | nullparent_idstring | nullmedia_idstring | nullreplies_countinteger | nullrepliesarray of object | nullShow 6 item attributes
idstringtextstringauthorstring | nullcreated_atstring (date-time)like_countintegerhiddenboolean | nullmediaobject | nullShow 5 child attributes
idstringcaptionstring | nullpermalinkstring (uri) | nullmedia_product_typestring | nullFEEDREELSSTORYAD
thumbnail_urlstring (uri) | nullResponses
Instagram: Get a Comments item
/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.
Try it with MCPAsk your agent to call instagram-comments-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlytextstringauthorstring | nullusername
author_idstring | nullcreated_atstring (date-time)like_countintegerhiddenboolean | nullparent_idstring | nullmedia_idstring | nullreplies_countinteger | nullrepliesarray of object | nullShow 6 item attributes
idstringtextstringauthorstring | nullcreated_atstring (date-time)like_countintegerhiddenboolean | nullmediaobject | nullShow 5 child attributes
idstringcaptionstring | nullpermalinkstring (uri) | nullmedia_product_typestring | nullFEEDREELSSTORYAD
thumbnail_urlstring (uri) | nullResponses
Instagram: Delete a Comments item
/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.
Try it with MCPAsk your agent to call instagram-comments-delete (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Instagram: Reply (Comments)
/accounts/{accountId}/instagram/comments/{itemId}/replyReply. 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.
Try it with MCPAsk your agent to call instagram-comments-reply (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
messagestringrequired≤ 2200 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Load replies (Comments)
/accounts/{accountId}/instagram/comments/{itemId}/repliesLoad 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.
Try it with MCPAsk your agent to call instagram-comments-replies (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Hide (Comments)
/accounts/{accountId}/instagram/comments/{itemId}/hideHide. 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.
Try it with MCPAsk your agent to call instagram-comments-hide (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Unhide (Comments)
/accounts/{accountId}/instagram/comments/{itemId}/unhideUnhide. 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.
Try it with MCPAsk your agent to call instagram-comments-unhide (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Like (Comments)
/accounts/{accountId}/instagram/comments/{itemId}/likeLike. 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.
Try it with MCPAsk your agent to call instagram-comments-like (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Unlike (Comments)
/accounts/{accountId}/instagram/comments/{itemId}/unlikeUnlike. 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.
Try it with MCPAsk your agent to call instagram-comments-unlike (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Reply privately (DM) (Comments)
/accounts/{accountId}/instagram/comments/{itemId}/private-replyOne 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.
Try it with MCPAsk your agent to call instagram-comments-private-reply (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstring | null≤1000 bytes; URLs must be valid
≤ 1000 characters
attachmentobject | nullShow 4 child attributes
typestringimagevideoaudiofile
urlstring (uri) | nullmedia_idstring | nullattachment_idstring | nullReusable id from the Attachment Upload API
attachmentsarray of object | nullMulti-image message (≤10 images)
≤ 10 items
Show 2 item attributes
typestringimage
urlstring (uri)quick_repliesarray of object | null≤ 13 items
Show 2 item attributes
titlestring≤ 20 characters
payloadstring | nullbuttonsarray of object | null≤ 3 items
Show 3 item attributes
titlestringurlstring (uri) | nullpayloadstring | nullelementsarray of object | nullGeneric template carousel
≤ 10 items
Show 4 item attributes
titlestringsubtitlestring | nullimage_urlstring (uri) | nullbuttonsarray of object | nullShow 4 item attributes
typestringtitlestringurlstring (uri) | nullpayloadstring | nullstickerstring | nulllike_heart
media_share_idstring | nullOwn post id to share (MEDIA_SHARE)
reply_tostring | nullMessage id to reply to
human_agentboolean | nullSend with the HUMAN_AGENT tag (up to 7 days after the last user message; needs the Human Agent feature)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mentions
Instagram: List Mentions & tags
/accounts/{accountId}/instagram/mentionsMedia 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.
Try it with MCPAsk your agent to call instagram-mentions-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
afterstringCursor from next_cursor
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 21 item attributes
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Get a Mentions & tags item
/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.
Try it with MCPAsk your agent to call instagram-mentions-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nullResponses
Instagram: Reply to mention (Mentions & tags)
/accounts/{accountId}/instagram/mentions/{itemId}/replyReply 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.
Try it with MCPAsk your agent to call instagram-mentions-reply (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
comment_idstring | nullmessagestringrequired≤ 2200 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Look up mentioning comment (Mentions & tags)
/accounts/{accountId}/instagram/mentions/mentioned-commentLook 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.
Try it with MCPAsk your agent to call instagram-mentions-mentioned-comment (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
comment_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Like (Mentions & tags)
/accounts/{accountId}/instagram/mentions/{itemId}/likeLike. 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.
Try it with MCPAsk your agent to call instagram-mentions-like (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Conversations
Instagram: List Direct
/accounts/{accountId}/instagram/conversations1: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.
Try it with MCPAsk your agent to call instagram-conversations-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
afterstringCursor from next_cursor
user_idstring | nullIGSID: find the thread with this user
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringupdated_atstring (date-time)unread_countintegerlast_messagestring | nullparticipantsarray of objectShow 3 item attributes
idstringnamestring | nullusernamestring | nullparticipantobject | nullShow 3 child attributes
idstringnamestring | nullusernamestring | nullmessagesarray of object | nullShow 8 item attributes
idstringtextstring | nulldirectionstringinout
sent_atstring (date-time)from_idstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring (uri) | nullreply_tostring | nullstory_replyobject | nullShow 2 child attributes
idstring | nullurlstring (uri) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Get a Direct item
/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.
Try it with MCPAsk your agent to call instagram-conversations-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringupdated_atstring (date-time)unread_countintegerlast_messagestring | nullparticipantsarray of objectShow 3 item attributes
idstringnamestring | nullusernamestring | nullparticipantobject | nullShow 3 child attributes
idstringnamestring | nullusernamestring | nullmessagesarray of object | nullShow 8 item attributes
idstringtextstring | nulldirectionstringinout
sent_atstring (date-time)from_idstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring (uri) | nullreply_tostring | nullstory_replyobject | nullShow 2 child attributes
idstring | nullurlstring (uri) | nullResponses
Instagram: Send message (Direct)
/accounts/{accountId}/instagram/conversations/{itemId}/sendSend 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.
Try it with MCPAsk your agent to call instagram-conversations-send (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipient_idstring | nulltextstring | null≤1000 bytes; URLs must be valid
≤ 1000 characters
attachmentobject | nullShow 4 child attributes
typestringimagevideoaudiofile
urlstring (uri) | nullmedia_idstring | nullattachment_idstring | nullReusable id from the Attachment Upload API
attachmentsarray of object | nullMulti-image message (≤10 images)
≤ 10 items
Show 2 item attributes
typestringimage
urlstring (uri)quick_repliesarray of object | null≤ 13 items
Show 2 item attributes
titlestring≤ 20 characters
payloadstring | nullbuttonsarray of object | null≤ 3 items
Show 3 item attributes
titlestringurlstring (uri) | nullpayloadstring | nullelementsarray of object | nullGeneric template carousel
≤ 10 items
Show 4 item attributes
titlestringsubtitlestring | nullimage_urlstring (uri) | nullbuttonsarray of object | nullShow 4 item attributes
typestringtitlestringurlstring (uri) | nullpayloadstring | nullstickerstring | nulllike_heart
media_share_idstring | nullOwn post id to share (MEDIA_SHARE)
reply_tostring | nullMessage id to reply to
human_agentboolean | nullSend with the HUMAN_AGENT tag (up to 7 days after the last user message; needs the Human Agent feature)
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: React (Direct)
/accounts/{accountId}/instagram/conversations/{itemId}/reactReact. 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.
Try it with MCPAsk your agent to call instagram-conversations-react (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
message_idstringrequiredreactionstring | nulldefault: "love"Emoji or "love"
recipient_idstring | nullReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Remove reaction (Direct)
/accounts/{accountId}/instagram/conversations/{itemId}/unreactRemove 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.
Try it with MCPAsk your agent to call instagram-conversations-unreact (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
message_idstringrequiredrecipient_idstring | nullReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Typing indicator (Direct)
/accounts/{accountId}/instagram/conversations/{itemId}/typingTyping 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.
Try it with MCPAsk your agent to call instagram-conversations-typing (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
onboolean | nulldefault: truerecipient_idstring | nullReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Mark as seen (Direct)
/accounts/{accountId}/instagram/conversations/{itemId}/mark-seenMark 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.
Try it with MCPAsk your agent to call instagram-conversations-mark-seen (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipient_idstring | nullReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Block user (Direct)
/accounts/{accountId}/instagram/conversations/{itemId}/blockBlock 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.
Try it with MCPAsk your agent to call instagram-conversations-block (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
recipient_idstring | nullReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Unblock user (Direct)
/accounts/{accountId}/instagram/conversations/{itemId}/unblockUnblock 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.
Try it with MCPAsk your agent to call instagram-conversations-unblock (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
recipient_idstring | nullReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Move to spam (Direct)
/accounts/{accountId}/instagram/conversations/{itemId}/spamMove 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.
Try it with MCPAsk your agent to call instagram-conversations-spam (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
recipient_idstring | nullReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Ice breakers
Instagram: Get Ice breakers
/accounts/{accountId}/instagram/ice-breakersUp 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.
Try it with MCPAsk your agent to call instagram-ice-breakers-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
ice_breakersarray of objectShow 2 item attributes
localestringdefault: "default"call_to_actionsarray of object≤ 4 items
Show 2 item attributes
questionstringrequired≤ 80 characters
payloadstring | nullResponses
Instagram: Update Ice breakers
/accounts/{accountId}/instagram/ice-breakersUp 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.
Try it with MCPAsk your agent to call instagram-ice-breakers-update (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
ice_breakersarray of objectShow 2 item attributes
localestring | nullcall_to_actionsarray of object≤ 4 items
Show 2 item attributes
questionstringrequired≤ 80 characters
payloadstring | nullquestionsarray of object | null≤ 4 items
Show 2 item attributes
questionstringrequired≤ 80 characters
payloadstring | nullReturns object
ice_breakersarray of objectShow 2 item attributes
localestringdefault: "default"call_to_actionsarray of object≤ 4 items
Show 2 item attributes
questionstringrequired≤ 80 characters
payloadstring | nullResponses
Instagram: Delete Ice breakers
/accounts/{accountId}/instagram/ice-breakersUp 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.
Try it with MCPAsk your agent to call instagram-ice-breakers-delete (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Persistent menu
Instagram: Get Persistent menu
/accounts/{accountId}/instagram/persistent-menuMenu 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.
Try it with MCPAsk your agent to call instagram-persistent-menu-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
persistent_menuarray of objectShow 3 item attributes
localestringdefault: "default"composer_input_disabledboolean | nullcall_to_actionsarray of objectShow 3 item attributes
titlestringrequiredurlstring (uri) | nullpayloadstring | nullResponses
Instagram: Update Persistent menu
/accounts/{accountId}/instagram/persistent-menuMenu 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.
Try it with MCPAsk your agent to call instagram-persistent-menu-update (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
persistent_menuarray of objectShow 3 item attributes
localestringdefault: "default"composer_input_disabledboolean | nullcall_to_actionsarray of objectShow 3 item attributes
titlestringrequiredurlstring (uri) | nullpayloadstring | nullResponses
Instagram: Delete Persistent menu
/accounts/{accountId}/instagram/persistent-menuMenu 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.
Try it with MCPAsk your agent to call instagram-persistent-menu-delete (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
People
Instagram: Get a People item
/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.
Try it with MCPAsk your agent to call instagram-people-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
user_idstringusernamestring | nullnamestring | nullis_followerboolean | nullis_followed_by_accountboolean | nullfollower_countinteger | nullis_verifiedboolean | nullunavailable_reasonstring | nullconsent_requireddm_access_disablednot_messageableerror
Responses
Message attachments
Instagram: Create a Reusable attachments item
/accounts/{accountId}/instagram/message-attachmentsUpload 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.
Try it with MCPAsk your agent to call instagram-message-attachments-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
typestringimagevideoaudiofile
urlstring (uri)requiredReturns object
attachment_idstringResponses
Account insights
Instagram: Get Account
/accounts/{accountId}/instagram/account-insightsViews, 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.
Try it with MCPAsk your agent to call instagram-account-insights-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date-time) | nulluntilstring (date-time) | nullmetricsarray of string | nullmetric_typestring | nulldefault: "total_value"total_valuetime_series
breakdownstring | nullmedia_product_typefollow_typecontact_button_type
Returns object
date_rangeobjectShow 2 child attributes
sincestringuntilstringmetric_typestringtotal_valuetime_series
breakdownstring | nullmetricsmap of objectunavailable_metricsarray of objectShow 2 item attributes
metricstringreasonstringResponses
Instagram: Normalized summary (Account)
/accounts/{accountId}/instagram/account-insights/summaryNormalized 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.
Try it with MCPAsk your agent to call instagram-account-insights-summary (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
sincestring (date-time) | nulluntilstring (date-time) | nullReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Content insights
Instagram: List Content
/accounts/{accountId}/instagram/content-insightsPer-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.
Try it with MCPAsk your agent to call instagram-content-insights-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date-time) | nulluntilstring (date-time) | nulllimitinteger | nulldefault: 25≤ 50
metricstring | nullviewsreachlikescommentssharessavesengagementsengagement_rate
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 16 item attributes
idstringcaptionstring | nullmedia_product_typestring | nullpermalinkstring (uri) | nullthumbnail_urlstring (uri) | nulltimestampstring (date-time)viewsnumber | nullreachnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullengagementsnumber | nullengagement_ratenumber | nullwatch_time_secondsnumber | nullavg_view_duration_secondsnumber | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Get a Content item
/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.
Try it with MCPAsk your agent to call instagram-content-insights-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringcaptionstring | nullmedia_product_typestring | nullpermalinkstring (uri) | nullthumbnail_urlstring (uri) | nulltimestampstring (date-time)viewsnumber | nullreachnumber | nulllikesnumber | nullcommentsnumber | nullsharesnumber | nullsavesnumber | nullengagementsnumber | nullengagement_ratenumber | nullwatch_time_secondsnumber | nullavg_view_duration_secondsnumber | nullResponses
Audience
Instagram: Get Audience
/accounts/{accountId}/instagram/audienceFollower 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.
Try it with MCPAsk your agent to call instagram-audience-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial 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 | nullReturns object
metricstringfollower_demographicsengaged_audience_demographics
timeframestringthis_weekthis_monthprev_monthlast_14_dayslast_30_dayslast_90_days
demographicsobjectShow 4 child attributes
agearray of objectShow 2 item attributes
keystringvaluenumbergenderarray of objectShow 2 item attributes
keystringvaluenumbercountryarray of objectShow 2 item attributes
keystringvaluenumbercityarray of objectShow 2 item attributes
keystringvaluenumberResponses
Online followers
Instagram: Get Best time to post
/accounts/{accountId}/instagram/online-followersHourly 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.
Try it with MCPAsk your agent to call instagram-online-followers-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
daysarray of objectShow 2 item attributes
datestringhoursmap of numberaverage_by_hourarray of objectShow 2 item attributes
hourinteger0–23
valuenumberbest_hoursarray of integerResponses
Follower history
Instagram: Get Followers
/accounts/{accountId}/instagram/follower-historyFollower 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.
Try it with MCPAsk your agent to call instagram-follower-history-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date-time) | nulluntilstring (date-time) | nullReturns object
current_followersinteger | nullmetricsobjectShow 3 child attributes
follower_countarray of objectShow 2 item attributes
datestring (date)valuenumberfollowers_gainedarray of objectShow 2 item attributes
datestring (date)valuenumberfollowers_lostarray of objectShow 2 item attributes
datestring (date)valuenumberResponses
Hashtags
Instagram: List Hashtag search
/accounts/{accountId}/instagram/hashtagsRecently 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.
Try it with MCPAsk your agent to call instagram-hashtags-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
idstringnamestringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Create a Hashtag search item
/accounts/{accountId}/instagram/hashtagsSearch 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.
Try it with MCPAsk your agent to call instagram-hashtags-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
qstringrequiredHashtag without #
Returns object
idstringnamestringResponses
Instagram: Get a Hashtag search item
/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.
Try it with MCPAsk your agent to call instagram-hashtags-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringnamestringResponses
Instagram: Top media (Hashtag search)
/accounts/{accountId}/instagram/hashtags/{itemId}/top-mediaTop 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.
Try it with MCPAsk your agent to call instagram-hashtags-top-media (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
limitintegerdefault: 251–100
afterstringCursor from next_cursor
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Instagram: Recent media (24 h) (Hashtag search)
/accounts/{accountId}/instagram/hashtags/{itemId}/recent-mediaRecent 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.
Try it with MCPAsk your agent to call instagram-hashtags-recent-media (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
limitintegerdefault: 251–100
afterstringCursor from next_cursor
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Business discovery
Instagram: Get a Competitors item
/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.
Try it with MCPAsk your agent to call instagram-business-discovery-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Query parameters
limitinteger | nulldefault: 12≤ 50
afterstring | nullReturns object
profileobjectShow 9 child attributes
idstringusernamestringnamestring | nullbiographystring | nullwebsitestring (uri) | nullprofile_picture_urlstring (uri) | nullfollowers_countinteger | nullfollows_countinteger | nullmedia_countinteger | nullmediaarray of objectShow 22 item attributes
idstringrequiredread-onlycaptionstring | null≤ 2200 characters
media_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_product_typestringFEEDREELSSTORYAD
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullpermalinkstring (uri) | nullshortcodestring | nulltimestampstring (date-time)usernamestring | nulllike_countinteger | nullcomments_countinteger | nullis_comment_enabledboolean | nullis_shared_to_feedboolean | nullalt_textstring | nullchildrenarray of object | nullShow 4 item attributes
idstringmedia_typestringIMAGEVIDEOCAROUSEL_ALBUM
media_urlstring (uri) | nullthumbnail_urlstring (uri) | nullreposts_countinteger | nullFacebook Login only
saved_countinteger | nullFacebook Login only
shares_countinteger | nullFacebook Login only
media_audio_typestring | nullMUSICORIGINAL_SOUND
is_ai_generatedboolean | nullview_countinteger | nullnext_cursorstring | nullResponses
Oembed
Instagram: Create a Embed item
/accounts/{accountId}/instagram/oembedEmbed 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.
Try it with MCPAsk your agent to call instagram-oembed-create (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
urlstring (uri)requiredmaxwidthinteger | nullhidecaptionboolean | nullomitscriptboolean | nullReturns object
htmlstringprovider_namestring | nullwidthinteger | nulltypestring | nullversionstring | nullResponses
Catalogs
Instagram: List Catalogs
/accounts/{accountId}/instagram/catalogsCatalogs 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.
Try it with MCPAsk your agent to call instagram-catalogs-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
catalog_idstringcatalog_namestring | nullshop_namestring | nullproduct_countinteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Catalog products
Instagram: List Products
/accounts/{accountId}/instagram/catalog-productsCursor 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.
Try it with MCPAsk your agent to call instagram-catalog-products-list (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
afterstringCursor from next_cursor
catalog_idstringqstring | nullReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
product_idstringmerchant_idstring | nullproduct_namestring | nullimage_urlstring (uri) | nullretailer_idstring | nullreview_statusstring | nullis_checkout_flowboolean | nullproduct_variantsarray of object | nullShow 2 item attributes
product_idstringvariant_namestring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Instagram: Appeal rejection (Products)
/accounts/{accountId}/instagram/catalog-products/{itemId}/appealAppeal 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.
Try it with MCPAsk your agent to call instagram-catalog-products-appeal (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
appeal_reasonstring | nullOmit to read the appeal status
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Product tags
Instagram: Get a Product tags item
/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.
Try it with MCPAsk your agent to call instagram-product-tags-get (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
media_idstringtagsarray of objectShow 5 item attributes
product_idstringnamestring | nullxnumber | nullynumber | nullreview_statusstring | nullResponses
Instagram: Update a Product tags item
/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.
Try it with MCPAsk your agent to call instagram-product-tags-update (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
tagsarray of objectrequired≤ 5 items
Show 3 item attributes
product_idstringrequiredxnumber | null0–1
ynumber | null0–1
Returns object
media_idstringtagsarray of objectShow 5 item attributes
product_idstringnamestring | nullxnumber | nullynumber | nullreview_statusstring | nullResponses
Instagram: Remove tags (Product tags)
/accounts/{accountId}/instagram/product-tags/{itemId}/removeRemove 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.
Try it with MCPAsk your agent to call instagram-product-tags-remove (toolset focus_instagram)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
product_idsarray of stringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)