Limited offer50% off your first month: the $99 plan for $4924 hours onlySee plans
← All integrations
Instagram logo

Instagram

Read posts, comments, and media.

SocialOAuth40 endpoints

Endpoints

OperationMethod & pathEffectLatencyRateCost
INSTAGRAM_CREATE_CAROUSEL_CONTAINER
Create 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.
POST /composio/instagram/instagram_create_carousel_containerexternal_send——managed
INSTAGRAM_CREATE_MEDIA_CONTAINER
DEPRECATED: Use INSTAGRAM_POST_IG_USER_MEDIA instead. Creates a draft media container for photos/videos/reels before publishing. Business/Creator accounts only — personal accounts unsupported. Returns a container ID (data.id or data.creation_id) used as creation_id for publishing. Containers expire in ~24 hours — recreate stale containers rather than reusing old IDs. Before publishing via INSTAGRAM_CREATE_POST, call INSTAGRAM_GET_POST_STATUS and wait for FINISHED status — publishing before FINISHED triggers error 9007. Each creation_id is one-time-use; if container creation fails (status_code='ERROR'), fix media params and recreate via this tool rather than retrying publish with the failed ID.
POST /composio/instagram/instagram_create_media_containerexternal_send——managed
INSTAGRAM_CREATE_POST
DEPRECATED: 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.
POST /composio/instagram/instagram_create_postexternal_send——managed
INSTAGRAM_DELETE_COMMENT
Tool 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.
POST /composio/instagram/instagram_delete_commentexternal_send——managed
INSTAGRAM_DELETE_MESSENGER_PROFILE
Delete ice breakers or a persistent menu from an Instagram messenger profile.
POST /composio/instagram/instagram_delete_messenger_profileexternal_send——managed
INSTAGRAM_ENABLE_WEBHOOK_SUBSCRIPTIONS
Enable 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.
POST /composio/instagram/instagram_enable_webhook_subscriptionsexternal_send——managed
INSTAGRAM_GET_CONVERSATION
Get 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.
GET /composio/instagram/instagram_get_conversationnone——managed
INSTAGRAM_GET_IG_COMMENT_REPLIES
Get 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.
GET /composio/instagram/instagram_get_ig_comment_repliesnone——managed
INSTAGRAM_GET_IG_MEDIA
Get 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.
GET /composio/instagram/instagram_get_ig_medianone——managed
INSTAGRAM_GET_IG_MEDIA_CHILDREN
Tool 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.
GET /composio/instagram/instagram_get_ig_media_childrennone——managed
INSTAGRAM_GET_IG_MEDIA_COMMENTS
List selected comments for an Instagram media object ID using fields, limit, and after cursors.
GET /composio/instagram/instagram_get_ig_media_commentsnone——managed
INSTAGRAM_GET_IG_MEDIA_INSIGHTS
Tool 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 shares for specific media. Note: Insights data is only available for media published within the last 2 years, and the account must have at least 1,000 followers. Requires a Business or Creator account; personal Instagram profiles are not supported.
GET /composio/instagram/instagram_get_ig_media_insightsnone——managed

Showing 12 of 40 Instagram actions. Every action is in the provider catalog, and the CLI and MCP list them with their inputs.