Open Connector
← All tools

Instagram logoInstagram

Publish media, read insights and comments, and manage professional-account messaging through the Instagram Graph API.

instagramvcatalog-v123 tools

Authentication

MethodKindStatusDetails
OAuth 2.0oauth2available—

Call a tool

import { createClient } from "@open-connector/sdk";const oc = createClient({  baseUrl: "https://api.openconnector.dev",  apiKey: process.env.OPEN_CONNECTOR_API_KEY!,});const result = await oc.executeTool({  slug: "INSTAGRAM_GET_IG_MEDIA",  connectedAccountId: "conn_...",  arguments: { /* match this tool's input schema */ },});
import Composio from "@composio/client";const composio = new Composio({  baseURL: "https://api.openconnector.dev/composio",  apiKey: process.env.OPEN_CONNECTOR_API_KEY!,});const result = await composio.tools.execute("INSTAGRAM_GET_IG_MEDIA", {  connected_account_id: "conn_...",  arguments: { /* match this tool's input schema */ },});
oc tools execute INSTAGRAM_GET_IG_MEDIA --data '{ }'

Tool catalog

Available tools

23 callable operations

Get Instagram MediaINSTAGRAM_GET_IG_MEDIAGets a published Instagram photo, video, story, reel, or carousel with selected metadata and engagement fields. Unpublished container IDs must be checked with the publishing-status flow instead.

Gets a published Instagram photo, video, story, reel, or carousel with selected metadata and engagement fields. Unpublished container IDs must be checked with the publishing-status flow instead.

Authentication

Connected account required

Scopes

instagram_basicpages_show_list

Tags

mediaread
Get IG Media ChildrenINSTAGRAM_GET_IG_MEDIA_CHILDRENGets the individual media objects contained in an Instagram carousel post.

Gets the individual media objects contained in an Instagram carousel post.

Authentication

Connected account required

Scopes

instagram_basicpages_show_list

Tags

mediacarouselread
Get IG Media CommentsINSTAGRAM_GET_IG_MEDIA_COMMENTSGets comments for media owned by the connected Instagram professional account with cursor pagination.

Gets comments for media owned by the connected Instagram professional account with cursor pagination.

Authentication

Connected account required

Scopes

instagram_manage_commentspages_show_list

Tags

mediacommentsread
Get IG Media InsightsINSTAGRAM_GET_IG_MEDIA_INSIGHTSGets supported performance metrics for a published Instagram media object.

Gets supported performance metrics for a published Instagram media object.

Authentication

Connected account required

Scopes

instagram_manage_insightspages_show_list

Tags

mediainsights
Get IG User Content Publishing LimitINSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMITGets current content-publishing quota usage for an Instagram professional account. Space polling calls apart to avoid provider rate limits.

Gets current content-publishing quota usage for an Instagram professional account. Space polling calls apart to avoid provider rate limits.

Authentication

Connected account required

Scopes

instagram_content_publishinstagram_basicpages_show_list

Tags

publishingquotaread
Get IG User Live MediaINSTAGRAM_GET_IG_USER_LIVE_MEDIAGets active live-broadcast media for an Instagram Business or Creator account.

Gets active live-broadcast media for an Instagram Business or Creator account.

Authentication

Connected account required

Scopes

instagram_basicpages_show_list

Tags

livemediaread
Get IG User MediaINSTAGRAM_GET_IG_USER_MEDIAGets media published by an Instagram Business or Creator account with pagination and time filters.

Gets media published by an Instagram Business or Creator account with pagination and time filters.

Authentication

Connected account required

Scopes

instagram_basicpages_show_list

Tags

mediaread
Get IG User StoriesINSTAGRAM_GET_IG_USER_STORIESGets currently active stories for an Instagram Business or Creator account.

Gets currently active stories for an Instagram Business or Creator account.

Authentication

Connected account required

Scopes

instagram_basicpages_show_list

Tags

storiesread
Get Messenger ProfileINSTAGRAM_GET_MESSENGER_PROFILEGets Instagram messaging profile settings such as ice breakers.

Gets Instagram messaging profile settings such as ice breakers.

Authentication

Connected account required

Scopes

instagram_manage_messagespages_manage_metadatapages_show_list

Tags

messagingprofileread
Get Page ConversationsINSTAGRAM_GET_PAGE_CONVERSATIONSGets Instagram conversations for a Facebook Page connected to an Instagram professional account.

Gets Instagram conversations for a Facebook Page connected to an Instagram professional account.

Authentication

Connected account required

Scopes

instagram_manage_messagespages_manage_metadatapages_show_list

Tags

messagingconversationsread
Get User InfoINSTAGRAM_GET_USER_INFOGets profile details and statistics for an Instagram Business or Creator account. Use me for the authenticated account.

Gets profile details and statistics for an Instagram Business or Creator account. Use me for the authenticated account.

Authentication

Connected account required

Scopes

instagram_basicpages_show_list

Tags

profileread
Get User InsightsINSTAGRAM_GET_USER_INSIGHTSGets account-level Instagram insights. Demographic metrics may require timeframe; total-value metrics may support breakdown.

Gets account-level Instagram insights. Demographic metrics may require timeframe; total-value metrics may support breakdown.

Authentication

Connected account required

Scopes

instagram_manage_insightspages_show_list

Tags

profileinsights
List All ConversationsINSTAGRAM_LIST_ALL_CONVERSATIONSLists Instagram DM conversations for a connected Page. An empty data list is a valid outcome.

Lists Instagram DM conversations for a connected Page. An empty data list is a valid outcome.

Authentication

Connected account required

Scopes

instagram_manage_messagespages_manage_metadatapages_show_list

Tags

messagingconversationsread
List All MessagesINSTAGRAM_LIST_ALL_MESSAGESLists messages in an Instagram DM conversation, including attachment-only messages.

Lists messages in an Instagram DM conversation, including attachment-only messages.

Authentication

Connected account required

Scopes

instagram_manage_messagespages_manage_metadatapages_show_list

Tags

messagingread
Mark SeenINSTAGRAM_MARK_SEENMarks messages from an Instagram-scoped user as seen. This visibly changes inbox state and requires an active messaging window.

Marks messages from an Instagram-scoped user as seen. This visibly changes inbox state and requires an active messaging window.

Authentication

Connected account required

Scopes

instagram_manage_messagespages_manage_metadatapages_show_list

Tags

messagingwrite
Post IG Comment RepliesINSTAGRAM_POST_IG_COMMENT_REPLIESReplies to a comment on media owned by an Instagram professional account. The message must satisfy Instagram comment limits.

Replies to a comment on media owned by an Instagram professional account. The message must satisfy Instagram comment limits.

Authentication

Connected account required

Scopes

instagram_manage_commentspages_show_list

Tags

commentswrite
Post IG Media CommentsINSTAGRAM_POST_IG_MEDIA_COMMENTSCreates a comment on an Instagram media object. The message must satisfy Instagram comment limits.

Creates a comment on an Instagram media object. The message must satisfy Instagram comment limits.

Authentication

Connected account required

Scopes

instagram_manage_commentspages_show_list

Tags

commentswrite
Post IG User MediaINSTAGRAM_POST_IG_USER_MEDIACreates an Instagram image, video, Reel, story, or carousel media container for the first step of publishing.

Creates an Instagram image, video, Reel, story, or carousel media container for the first step of publishing.

Authentication

Connected account required

Scopes

instagram_content_publishinstagram_basicpages_show_list

Tags

publishingmediawrite
Publish IG User MediaINSTAGRAM_POST_IG_USER_MEDIA_PUBLISHWaits for a media container to finish processing, then publishes it to an Instagram Business or Creator account.

Waits for a media container to finish processing, then publishes it to an Instagram Business or Creator account.

Authentication

Connected account required

Scopes

instagram_content_publishinstagram_basicpages_show_list

Tags

publishingmediawrite
Reply to IG User MentionsINSTAGRAM_POST_IG_USER_MENTIONSReplies to a media-caption or comment mention of the connected Instagram professional account.

Replies to a media-caption or comment mention of the connected Instagram professional account.

Authentication

Connected account required

Scopes

instagram_manage_commentspages_show_list

Tags

mentionscommentswrite
Send ImageINSTAGRAM_SEND_IMAGESends an image URL in an existing Instagram DM conversation. Requires explicit user approval for automated sends.

Sends an image URL in an existing Instagram DM conversation. Requires explicit user approval for automated sends.

Authentication

Connected account required

Scopes

instagram_manage_messagespages_manage_metadatapages_show_list

Tags

messagingmediawrite
Send Text MessageINSTAGRAM_SEND_TEXT_MESSAGESends text in an existing Instagram DM conversation. It cannot initiate a new thread and provider messaging-window failures are preserved.

Sends text in an existing Instagram DM conversation. It cannot initiate a new thread and provider messaging-window failures are preserved.

Authentication

Connected account required

Scopes

instagram_manage_messagespages_manage_metadatapages_show_list

Tags

messagingwrite
Update Messenger ProfileINSTAGRAM_UPDATE_MESSENGER_PROFILEUpdates supported Instagram messaging profile settings such as ice breakers.

Updates supported Instagram messaging profile settings such as ice breakers.

Authentication

Connected account required

Scopes

instagram_manage_messagespages_manage_metadatapages_show_list

Tags

messagingprofilewrite

Provider resources