Read posts, comments, and media.
SocialOAuth40 endpoints
Endpoints
| Operation | Method & path | Effect | Latency | Rate | Cost |
|---|---|---|---|---|---|
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_container | external_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_container | external_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_post | external_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_comment | external_send | — | — | managed |
INSTAGRAM_DELETE_MESSENGER_PROFILE Delete ice breakers or a persistent menu from an Instagram messenger profile. | POST /composio/instagram/instagram_delete_messenger_profile | external_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_subscriptions | external_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_conversation | none | — | — | 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_replies | none | — | — | 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_media | none | — | — | 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_children | none | — | — | 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_comments | none | — | — | 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_insights | none | — | — | managed |
Showing 12 of 40 Instagram actions. Every action is in the provider catalog, and the CLI and MCP list them with their inputs.