# Instagram

Instagram is a social media platform for sharing photos, videos, and stories. Only supports Instagram Business and Creator accounts, not Instagram Personal accounts.

- **Category:** social media accounts
- **Auth:** OAUTH2
- **Tools:** 32
- **Triggers:** 0
- **Slug:** `INSTAGRAM`
- **Version:** 20260217_00

## Tools

### Create Carousel Container

**Slug:** `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.

### Create Media Container

**Slug:** `INSTAGRAM_CREATE_MEDIA_CONTAINER`

Create a draft media container for photos/videos/reels before publishing.

### Create Post

**Slug:** `INSTAGRAM_CREATE_POST`

Publish a draft media container to Instagram (final publishing step). IMPORTANT: After creating a media container, Instagram may need time to process the media before it can be published. If called immediately after container creation, you may receive error code 9007 ("The media is not ready for publishing"). This action automatically retries with exponential backoff (up to ~44 seconds total) to handle this processing delay. For large videos or slow processing, consider using INSTAGRAM_GET_POST_STATUS to poll the container status until it shows 'FINISHED' before calling this action.

### Delete Comment

**Slug:** `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.

### Get Conversation

**Slug:** `INSTAGRAM_GET_CONVERSATION`

Get details about a specific Instagram DM conversation (participants, etc).

### Get IG Comment Replies

**Slug:** `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 Instagram Media

**Slug:** `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 IG Media Children

**Slug:** `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 IG Media Comments

**Slug:** `INSTAGRAM_GET_IG_MEDIA_COMMENTS`

Tool to retrieve comments on an Instagram media object. Use when you need to fetch comments from a specific Instagram post, photo, video, or carousel. Supports cursor-based pagination for navigating through large comment lists.

### Get IG Media Insights

**Slug:** `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.

### Get IG User Content Publishing Limit

**Slug:** `INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT`

Get an Instagram Business Account's current content publishing usage. Use this to monitor quota usage and avoid hitting rate limits when publishing content via the API. 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.

### Get IG User Live Media

**Slug:** `INSTAGRAM_GET_IG_USER_LIVE_MEDIA`

Get live media objects during an active Instagram broadcast. 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.

### Get IG User Media

**Slug:** `INSTAGRAM_GET_IG_USER_MEDIA`

Get Instagram user's media collection (posts, photos, videos, reels, carousels). Use when you need to retrieve all media published by an Instagram Business or Creator account with support for pagination and time-based filtering.

### Get IG User Stories

**Slug:** `INSTAGRAM_GET_IG_USER_STORIES`

Get active story media objects for an Instagram Business or Creator account. 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.

### Get IG User Tags

**Slug:** `INSTAGRAM_GET_IG_USER_TAGS`

Get Instagram media where the user has been tagged by other users. Use when you need to retrieve all media in which an Instagram Business or Creator account has been tagged, including tags in captions, comments, or on the media itself.

### Get Post Comments

**Slug:** `INSTAGRAM_GET_POST_COMMENTS`

Get comments on an Instagram post.

### Get Post Insights

**Slug:** `INSTAGRAM_GET_POST_INSIGHTS`

Get Instagram post insights/analytics (impressions, reach, engagement, etc.).

### Get Post Status

**Slug:** `INSTAGRAM_GET_POST_STATUS`

Check the processing status of a draft post container.

### Get User Info

**Slug:** `INSTAGRAM_GET_USER_INFO`

Get Instagram user info including profile details and statistics.

### Get User Insights

**Slug:** `INSTAGRAM_GET_USER_INSIGHTS`

Get Instagram account-level insights and analytics (profile views, reach, follower count, etc.). 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.

### Get User Media

**Slug:** `INSTAGRAM_GET_USER_MEDIA`

Get Instagram user's media (posts, photos, videos).

### List All Conversations

**Slug:** `INSTAGRAM_LIST_ALL_CONVERSATIONS`

List all Instagram DM conversations for the authenticated user.

### List All Messages

**Slug:** `INSTAGRAM_LIST_ALL_MESSAGES`

List all messages from a specific Instagram DM conversation.

### Mark Seen

**Slug:** `INSTAGRAM_MARK_SEEN`

Mark Instagram DM messages as read/seen for a specific user. This action sends a 'mark_seen' sender action to indicate that messages from the specified recipient have been read. This is similar to the Facebook Messenger sender_action feature. 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.

### Post IG Comment Replies

**Slug:** `INSTAGRAM_POST_IG_COMMENT_REPLIES`

Tool to create a reply to an Instagram comment. 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.

### Post IG Media Comments

**Slug:** `INSTAGRAM_POST_IG_MEDIA_COMMENTS`

Tool to create a comment on an Instagram media object. 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.

### Post IG User Media

**Slug:** `INSTAGRAM_POST_IG_USER_MEDIA`

Tool to create a media container for Instagram posts. 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.

### Publish IG User Media

**Slug:** `INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH`

Tool to publish a media container to an Instagram Business account. This action automatically waits for the container to finish processing before publishing. Rate limited to 25 API-published posts per 24-hour moving window. 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.

### Reply to IG User Mentions

**Slug:** `INSTAGRAM_POST_IG_USER_MENTIONS`

Tool to reply to a mention of your Instagram Business or Creator account. 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.

### Reply To Comment

**Slug:** `INSTAGRAM_REPLY_TO_COMMENT`

Reply to a comment on Instagram media.

### Send Image

**Slug:** `INSTAGRAM_SEND_IMAGE`

Send an image via Instagram DM to a specific user.

### Send Text Message

**Slug:** `INSTAGRAM_SEND_TEXT_MESSAGE`

Send a text message to an Instagram user via DM.
