← Catalog

Instagram

Connect Instagram to Claude Code, Codex, Cursor or any MCP agent through CoreSpeed. Instagram Business/Creator accounts only — publish media, read media/comments/insights, reply to comments, and manage DMs via Instagram Login (Composio managed). Your agent works through your own Instagram account and gets 28 Instagram tools; CoreSpeed holds the credential, so the agent never sees the token. Calling it is free.

Tools28

  • instagram__create_carousel_containerCreate a draft carousel post with multiple images/videos before publishing.
    Free

    Instagram requires carousels to have between 2 and 10 media items. Container creation_ids expire in under 24 hours, so publish promptly after creation. Creates a draft container only; nothing is visible until post_ig_user_media_publish runs.

  • instagram__delete_commentTool to delete a comment on Instagram media.
    Free

    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. Irreversible. May fail with a permission error until the managed Meta app is approved for instagram_business_manage_comments.

  • instagram__delete_messenger_profileDelete ice breakers or a persistent menu from an Instagram messenger profile.
    Free

    Irreversible; confirm the fields before execution.

  • instagram__get_conversationGet details about a specific Instagram DM conversation (participants, etc).
    Free

    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.

  • instagram__get_ig_comment_repliesGet replies to a specific Instagram comment.
    Free

    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.

  • instagram__get_ig_mediaGet a published Instagram Media object (photo, video, story, reel, or carousel).
    Free

    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.

  • instagram__get_ig_media_childrenTool to get media objects (images/videos) that are children of an Instagram carousel/album post.
    Free

    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.

  • instagram__get_ig_media_commentsTool to retrieve comments on an Instagram media object.
    Free

    Use when you need to fetch comments from a specific Instagram post, photo, video, or carousel owned by the connected Business/Creator account. Supports cursor-based pagination for navigating through large comment lists. An empty data array in the response indicates the post has no comments and is not an error. Bulk-fetching across many media objects may trigger API rate limits.

  • instagram__get_ig_media_insightsTool to get insights and metrics for Instagram media objects (photos, videos, reels, carousel albums).
    Free

    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.

  • instagram__get_ig_user_content_publishing_limitGet an Instagram Business Account's current content publishing usage.
    Free

    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.

  • instagram__get_ig_user_live_mediaGet live media objects during an active Instagram broadcast.
    Free

    Returns the live video media ID and metadata when a live broadcast is in progress on an Instagram Business or Creator account. Use this to monitor active live streams and access real-time engagement data.

  • instagram__get_ig_user_mediaGet Instagram user's media collection (posts, photos, videos, reels, carousels).
    Free

    Use when you need to retrieve all media published by an Instagram Business or Creator account with support for pagination and time-based filtering.

  • instagram__get_ig_user_storiesGet active story media objects for an Instagram Business or Creator account.
    Free

    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.

  • instagram__get_messenger_profileGet the messenger profile settings for an Instagram account.
    Free

    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.

  • instagram__get_page_conversationsGet Instagram conversations for a Page connected to an Instagram Business account.
    Free

    Use platform=instagram parameter to filter for Instagram conversations only.

  • instagram__get_user_infoGet Instagram Business Account info including profile details and statistics.
    Free

    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.

  • instagram__get_user_insightsGet Instagram account-level insights and analytics (profile views, reach, follower count, etc.).
    Free

    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.

  • instagram__list_all_conversationsList all Instagram DM conversations for the authenticated user.
    Free

    Requires a Business/Creator account with messaging permissions; personal accounts return empty results. Response conversations are nested under `data.data` — accessing top-level `data` as the final list returns zero items. An empty `data` list is a valid non-error outcome meaning no conversations exist in scope.

  • instagram__list_all_messagesList all messages from a specific Instagram DM conversation.
    Free

    Requires a Business or Creator account with messaging permissions; personal accounts return empty results. Response data is nested under data.data (double-wrapped); attachment-only messages may have empty text fields.

  • instagram__mark_seenMark Instagram DM messages as read/seen for a specific user.
    Free

    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.

  • instagram__post_ig_comment_repliesTool to create a reply to an Instagram comment.
    Free

    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. Creates a public reply; confirm the target and text before execution. May fail with a permission error until the managed Meta app is approved for instagram_business_manage_comments.

  • instagram__post_ig_media_commentsTool to create a comment on an Instagram media object.
    Free

    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. Creates a public comment; confirm the target and text before execution. May fail with a permission error until the managed Meta app is approved for instagram_business_manage_comments.

  • instagram__post_ig_user_mediaTool to create a media container for Instagram posts.
    Free

    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. Creates a draft container only; nothing is visible until post_ig_user_media_publish runs.

  • instagram__post_ig_user_media_publishTool to publish a media container to an Instagram Business account.
    Free

    This action automatically waits for the container to finish processing before publishing. Instagram enforces an account-specific content-publishing rate limit over a 24-hour moving window; the exact cap varies by account and should be read live via INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT before bulk publishing. The publishing process: 1. First, create a media container using INSTAGRAM_CREATE_MEDIA_CONTAINER 2. Call this action with the creation_id - it will automatically poll for FINISHED status 3. Once ready, the media is published and the published media ID is returned For videos/reels, processing may take 30-120 seconds. Images are typically instant. Publishes immediately and publicly; confirm intent before execution.

  • instagram__post_ig_user_mentionsTool to reply to a mention of your Instagram Business or Creator account.
    Free

    Use when you need to respond to comments or media captions where your account has been @mentioned by another Instagram user. This creates a comment on the media or comment containing the mention. Creates a public comment; confirm the target and text before execution.

  • instagram__send_imageSend an image via Instagram DM to a specific user.
    Free

    Each send modifies inbox state; avoid bulk or automated sends without explicit user approval. Delivers a DM to a real user; confirm the recipient before execution.

  • instagram__send_text_messageSend a text message to an Instagram user via DM in an existing conversation.
    Free

    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. Delivers a DM to a real user; confirm the recipient and text before execution.

  • instagram__update_messenger_profileTool to update the messenger profile settings for an Instagram account.
    Free

    Use when you need to configure ice breakers and messaging options. Ice breakers are suggested questions that help users start conversations with your Instagram Business account.

Pages about Instagram

Give this to your agent

set up https://corespeed.io/SKILL.md
Get started
FAQ

Questions people ask.