- Category: social media accounts
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 40
- Triggers: 0
- Slug:
INSTAGRAM - Version: 20261101_00
Frequently Asked Questions
Instagram requires a Business or Creator account
Instagram requires a Business or Creator account
Why can Instagram reply-to-comment fail with the managed OAuth app?
Why can Instagram reply-to-comment fail with the managed OAuth app?
instagram_manage_comments for Facebook Login or instagram_business_manage_comments for Instagram Business Login. Those permissions must be configured on the Meta app and approved by Meta before the OAuth flow can grant them.If a reply-to-comment flow fails because the managed OAuth app does not currently have the required comment permission, use your own Meta OAuth app with that permission configured and approved. Composio is working on managed-app approval for the missing permission, but an owned Meta app is the current unblock path for production usage.Tools
Create Carousel Container
Create Carousel Container
INSTAGRAM_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 publish promptly after creation.Input Parameters
Output
Create Media Container (Deprecated)
Create Media Container (Deprecated)
INSTAGRAM_CREATE_MEDIA_CONTAINERDEPRECATED: Creates a draft media container for photos, videos or Reels for a Business or Creator account. Returns an ID for subsequent publishing; containers expire after about 24 hours and must finish processing before publication.Input Parameters
Output
Create Post (Deprecated)
Create Post (Deprecated)
INSTAGRAM_CREATE_POSTDEPRECATED: Use INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH instead. Publish a draft media container to Instagram (final publishing step). Posts become immediately and publicly visible upon success — confirm intent before calling. Requires Business or Creator account with publish scopes; missing scopes return Graph error code 10. After creating a media container, Instagram may need time to process media before publishing. If called too early, error code 9007 is returned. This action automatically retries with exponential backoff (up to ~44 seconds total). For large videos, use INSTAGRAM_GET_POST_STATUS to poll until status_code=‘FINISHED’ before calling; for carousels, all child containers must individually reach FINISHED status first. No native scheduling support — use an external scheduler to trigger this call at the desired time.Input Parameters
Output
Delete Comment
Delete Comment
INSTAGRAM_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 created - you cannot delete other users’ comments unless they are on your own media.Input Parameters
Output
Delete Messenger Profile
Delete Messenger Profile
Enable Webhook Subscriptions
Enable Webhook Subscriptions
INSTAGRAM_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 subscriptions. The Meta app must be Live, have its callback configured, and meet Advanced Access and business verification prerequisites before this action is used.Input Parameters
Output
Get Conversation
Get Conversation
INSTAGRAM_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. Newly sent/received messages may take a few seconds to appear in results.Input Parameters
Output
Get IG Comment Replies
Get IG Comment Replies
INSTAGRAM_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 specific parent comment.Input Parameters
Output
Get Instagram Media
Get Instagram Media
INSTAGRAM_GET_IG_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, caption, media URLs, and metadata. NOTE: This action is for published media only. For unpublished container IDs (from INSTAGRAM_CREATE_MEDIA_CONTAINER), use INSTAGRAM_GET_POST_STATUS to check status instead.Input Parameters
Output
Get IG Media Children
Get IG Media Children
INSTAGRAM_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 children media do not support insights queries - for analytics, query metrics at the parent carousel level.Input Parameters
Output
List Media Comments
List Media Comments
INSTAGRAM_GET_IG_MEDIA_COMMENTSList selected comments for an Instagram media object ID using fields, limit, and after cursors.Input Parameters
Output
Get IG Media Insights
Get IG Media Insights
INSTAGRAM_GET_IG_MEDIA_INSIGHTSGet performance insights for an Instagram media object, such as views, reach, likes, comments, saves and shares. Requires a Business or Creator account. Some metric names are normalized, and certain invalid or deprecated metrics are removed; the response reports removals and substitutions.Input Parameters
Output
Get IG User Content Publishing Limit
Get IG User Content Publishing Limit
INSTAGRAM_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 failure — new publish calls are rejected until reset). IMPORTANT: This endpoint requires an IG User ID (Instagram Business Account ID), NOT an IGSID (Instagram Scoped ID). IGSID is only used for messaging-related endpoints. Content publishing endpoints require a proper IG User ID. Excessive polling of this endpoint may trigger Graph error 613 (rate limit); space calls several seconds apart.Input Parameters
Output
Get IG User Live Media
Get IG User Live Media
INSTAGRAM_GET_IG_USER_LIVE_MEDIAGet live media objects for an Instagram Business or Creator account during an active broadcast, including the live video media ID and metadata.Input Parameters
Output
List User Media
List User Media
INSTAGRAM_GET_IG_USER_MEDIAList one cursor-paginated page of user media with selected fields; use ig_user_id=‘me’ for the authenticated account.Input Parameters
Output
Get IG User Stories
Get IG User Stories
INSTAGRAM_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 this to retrieve story content, metadata, and engagement metrics for monitoring or analytics purposes.Input Parameters
Output
Get Messenger Profile
Get Messenger Profile
INSTAGRAM_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 messenger configuration for an Instagram Business account.Input Parameters
Output
Get Multiple Graph Nodes
Get Multiple Graph Nodes
Get Page Conversations
Get Page Conversations
INSTAGRAM_GET_PAGE_CONVERSATIONSGet a page of Instagram conversations for an Instagram Business account, with cursor pagination.Input Parameters
Output
Get Post Comments (Deprecated)
Get Post Comments (Deprecated)
INSTAGRAM_GET_POST_COMMENTSDEPRECATED: Use INSTAGRAM_GET_IG_MEDIA_COMMENTS instead. Get comments on an Instagram post. Requires Instagram Business or Creator account. Returns empty data array (not an error) when no comments exist. Response data is nested under data.data; unwrap before processing. Timestamps are timezone-aware ISO 8601 strings; use UTC-based comparison.Input Parameters
paging.cursors.after in the response.paging.cursors.before in the response.Output
Get Post Insights (Deprecated)
Get Post Insights (Deprecated)
INSTAGRAM_GET_POST_INSIGHTSGet insights for an Instagram post from a Business or Creator account, using its numeric media ID and selected metrics or a metric preset. Available metrics vary by media type. DEPRECATED: Use INSTAGRAM_GET_IG_MEDIA_INSIGHTS instead.Input Parameters
Output
Get Post Status (Deprecated)
Get Post Status (Deprecated)
INSTAGRAM_GET_POST_STATUSDEPRECATED: Use GetIgMedia instead. Check the processing status of a draft post container. Poll until status_code=‘FINISHED’ before calling INSTAGRAM_CREATE_POST; publishing early triggers OAuthException 9007 (HTTP 400). If status_code=‘ERROR’ or remains non-terminal after ~30 attempts, the container is permanently failed — recreate a new container. Poll every 3–5s with exponential backoff to avoid error 613/code 4/HTTP 429. For carousels, all child containers must reach FINISHED before publishing the parent.Input Parameters
Output
Get User Info
Get User Info
INSTAGRAM_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. NOTE: followers_count and follows_count are returned for your own profile (ig_user_id=“me”). For other accounts, follower/follow counts are surfaced through the business_discovery edge rather than this direct-node action, so they may be null here.Input Parameters
Output
Get User Insights
Get User Insights
INSTAGRAM_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 UTC. metric_type (time_series or total_value): When set to total_value, the API returns a total_value object instead of values. breakdown: Only applicable when metric_type=total_value and only for supported metrics. timeframe: Required for demographics-related metrics and overrides since/until for those metrics.Input Parameters
timeframe. All metrics in one call must share a period. Empty results are valid when data is unavailable (follower_count/online_followers require 100 followers; Threads metrics require a linked Threads profile). Rejected by Meta, do not request: impressions, email_contacts, phone_call_clicks, text_message_clicks, get_directions_clicks, audience_*.Output
Get User Media (Deprecated)
Get User Media (Deprecated)
INSTAGRAM_GET_USER_MEDIADEPRECATED: Use INSTAGRAM_GET_IG_USER_MEDIA instead. Get Instagram user’s media (posts, photos, videos). Only works for connected Business or Creator accounts; personal accounts return no data. Response data is nested under data.data; unwrap before processing. Items mix images, videos, carousels, and reels — filter by media_type and media_product_type. Use media_url for file download, permalink for share links. Fields like caption, like_count may be null. Timestamps are UTC ISO 8601. HTTP 429 with Retry-After header indicates rate limiting.Input Parameters
paging.cursors.after from the response to paginate; set an upper bound (e.g., ~300 posts) to avoid unbounded loops.after for complete results.Output
List All Conversations
List All Conversations
INSTAGRAM_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.Input Parameters
Output
List All Messages
List All Messages
INSTAGRAM_LIST_ALL_MESSAGESList one cursor-paginated page of messages from a specific Instagram DM conversation, with a caller-selectable field projection. Set the page size and use the returned cursor to retrieve the next page.Input Parameters
Output
List Subscribed Apps
List Subscribed Apps
INSTAGRAM_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; Meta does not expose a continuation input for this edge.Input Parameters
Output
Mark Seen
Mark Seen
INSTAGRAM_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 party and changes inbox read state — use with explicit user approval in automated or bulk flows. IMPORTANT LIMITATIONS: - The sender_action API feature may have limited support on Instagram - The recipient must have an active 24-hour messaging window open - Requires instagram_manage_messages permission - Only works with Instagram Business or Creator accounts If this action fails with a 500 error, it may indicate that the sender_action feature is not supported for your Instagram account or the specific recipient.Input Parameters
Output
Post IG Comment Replies
Post IG Comment Replies
INSTAGRAM_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, contain at most 4 hashtags and 1 URL, and cannot consist entirely of capital letters.Input Parameters
Output
Post IG Media Comments
Post IG Media Comments
INSTAGRAM_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 at most 4 hashtags and 1 URL, and cannot consist entirely of capital letters.Input Parameters
Output
Post IG User Media
Post IG User Media
INSTAGRAM_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 creating the container, use the media_publish endpoint to publish it.Input Parameters
Output
Publish IG User Media
Publish IG User Media
INSTAGRAM_POST_IG_USER_MEDIA_PUBLISHPublish a media container to an Instagram Business account and return the published media ID. By default, the action polls for FINISHED status before publishing, subject to a wait timeout; setting the wait to zero skips status checks and attempts immediate publication.Input Parameters
Output
Send Image
Send Image
INSTAGRAM_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.Input Parameters
Output
Send Text Message
Send Text Message
INSTAGRAM_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 messaging permissions. Fails with error_subcode 2534022 if outside the messaging window; do not retry these failures.Input Parameters
Output
Set Media Comment Availability
Set Media Comment Availability
Update Messenger Profile
Update Messenger Profile
INSTAGRAM_UPDATE_MESSENGER_PROFILEUpdate ice breakers for an Instagram Business account’s messenger profile. Ice breakers are suggested questions that help users start conversations.