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 | — | — | 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_container | external_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_post | external_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_comment | external_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_profile | external_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_subscriptions | external_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_conversation | none | — | — | 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_replies | none | — | — | 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_media | none | — | — | 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_children | none | — | — | 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_comments | none | — | — | 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_insights | none | — | — | 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.