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——no bill
INSTAGRAM_CREATE_MEDIA_CONTAINER
DEPRECATED: 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.
POST /composio/instagram/instagram_create_media_containerexternal_send——no bill
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——no bill
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——no bill
INSTAGRAM_DELETE_MESSENGER_PROFILE
Delete ice breakers or a persistent menu from an Instagram messenger profile.
POST /composio/instagram/instagram_delete_messenger_profileexternal_send——no bill
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——no bill
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——no bill
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——no bill
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——no bill
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——no bill
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——no bill
INSTAGRAM_GET_IG_MEDIA_INSIGHTS
Get 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.
GET /composio/instagram/instagram_get_ig_media_insightsnone——no bill

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