Instagram for AI agents
Agents read Instagram at once. Changes and sends are held for a person's approval by default.
About Instagram
Instagram is a social media platform for sharing photos, videos, and stories. Only supports Instagram Business and Creator accounts, not Instagram Personal accounts.
What an agent can do in Instagram
Every Instagram action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Instagram without asking first. 19 actions.
- Get Instagram MediaGet a published Instagram Media object (photo, video, story, reel, or carousel). Use when you need to retrieve detailed information about a specific Instagram post including engagement metrics, captio
- List Media CommentsList selected comments for an Instagram media object ID using fields, limit, and after cursors.
- Get IG Media InsightsTool to get insights and metrics for Instagram media objects (photos, videos, reels, carousel albums). Use when you need to retrieve performance data such as views, reach, likes, comments, saves, and
- List User MediaList one cursor-paginated page of user media with selected fields; use ig_user_id='me' for the authenticated account.
- Get Multiple Graph NodesRetrieve the same selected fields for multiple Instagram Graph nodes, preserving the provider's ID-to-object mapping.
- Get Page ConversationsGet Instagram conversations for a Page connected to an Instagram Business account. Use platform=instagram parameter to filter for Instagram conversations only.
- List Subscribed AppsReturn one provider page of apps enabled for webhook notifications on the authenticated Instagram professional account, including subscribed fields. Check paging.next in the response when present; Met
- Get ConversationGet details about a specific Instagram DM conversation (participants, etc). Requires a Business or Creator account with Instagram messaging permissions; personal accounts will return permission errors
- Get IG Comment RepliesGet replies to a specific Instagram comment. Returns a list of comment replies with details like text, username, timestamp, and like count. Use when you need to retrieve child comments (replies) for a
- Get IG Media ChildrenTool to get media objects (images/videos) that are children of an Instagram carousel/album post. Use when you need to retrieve individual media items from a carousel album post. Note: Carousel childre
- Get IG User Content Publishing LimitGet an Instagram Business Account's current content publishing usage. Use this to monitor quota usage before publishing; exceeding the daily cap blocks new posts until the quota resets (no partial fai
- Get IG User Live MediaGet live media objects during an active Instagram broadcast. Returns the live video media ID and metadata when a live broadcast is in progress on an Instagram Business or Creator account. Use this to
Show all 19
- Get IG User StoriesGet active story media objects for an Instagram Business or Creator account. Stories are retrieved via the /stories endpoint. Returns stories that are currently active within the 24-hour window. Use t
- Get IG User TagsGet one page of media tagging an Instagram Business or Creator account using Instagram Login. Select fields and use the returned cursors for pagination. Requires basic access and comment-management pe
- Get Messenger ProfileGet the messenger profile settings for an Instagram account. Returns ice breakers and other messaging configuration. Use when you need to retrieve messaging settings, ice breaker questions, or messeng
- Get User InfoGet Instagram Business Account info including profile details and statistics. Use "me" to query your own authenticated account, or provide the numeric Business Account ID of an account you manage. NOT
- Get User InsightsGet Instagram account-level insights and analytics (profile views, reach, follower count, etc.). Requires a Business or Creator account; personal accounts are not supported. Returned timestamps are in
- List All ConversationsList one cursor-paginated page of Instagram DM conversations for the authenticated or specified Business/Creator account, optionally selecting conversation fields and filtering for one participant.
- List All MessagesList one cursor-paginated page of messages from a specific Instagram DM conversation using an exact caller-selectable field projection.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 14 actions.
- Create Carousel ContainerCreate a draft carousel post with multiple images/videos before publishing. Instagram requires carousels to have between 2 and 10 media items. Container creation_ids expire in under 24 hours, so publi
- Enable Webhook SubscriptionsEnable selected Instagram Login webhook fields for delivery to the connected professional account. This enables account delivery only; it does not configure the callback URL or app-level webhook subsc
- Post IG Comment RepliesTool to create a reply to an Instagram comment. Use when you need to reply to a specific comment on an Instagram post owned by a Business or Creator account. The reply must be 300 characters or less,
- Post IG Media CommentsTool to create a comment on an Instagram media object. Use when you need to post a comment on a specific Instagram post, photo, video, or carousel. The comment must be 300 characters or less, contain
- Post IG User MediaTool to create a media container for Instagram posts. Use this to create a container for images, videos, Reels, or carousels. This is the first step in Instagram's two-step publishing process - after
- Publish IG User MediaTool to publish a media container to an Instagram Business account. This action automatically waits for the container to finish processing before publishing. Instagram enforces an account-specific con
- Send Text MessageSend a text message to an Instagram user via DM in an existing conversation. Cannot initiate new DM threads — a prior conversation must exist. Requires an Instagram Business or Creator account with me
- Set Media Comment AvailabilityEnable or disable new comments on owned, published Instagram media. Live video media is not supported by Meta.
- Update Messenger ProfileTool to update the messenger profile settings for an Instagram account. Use when you need to configure ice breakers and messaging options. Ice breakers are suggested questions that help users start co
- Delete CommentTool to delete a comment on Instagram media. Use when you need to remove a comment that was created by your Instagram Business or Creator Account. Note: You can only delete comments that your account
- Delete Messenger ProfileDelete ice breakers or a persistent menu from an Instagram messenger profile.
- Mark SeenMark Instagram DM messages as read/seen for a specific user. Sends a 'mark_seen' sender action to indicate messages from the specified recipient have been read. Marking as seen is visible to the other
Show all 14
- Reply to IG User MentionsTool to reply to a mention of your Instagram Business or Creator account. Use when you need to respond to comments or media captions where your account has been @mentioned by another Instagram user. T
- Send ImageSend an image via Instagram DM to a specific user. Each send modifies inbox state; avoid bulk or automated sends without explicit user approval.
Changes wait in Needs you
Changes and sends in Instagram are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Instagram questions
Can an agent change data in Instagram on its own?
Not by default. Changes and sends in Instagram are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Instagram?
This connector lists 19 read actions. Reads run at once, without waiting for approval.
How does Instagram connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.