> ## Documentation Index > Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt > Use this file to discover all available pages before exploring further. # Instagram > Instagram is a social media platform for sharing photos, videos, and stories Instagram is a social media platform for sharing photos, videos, and stories. Only supports Instagram Business and Creator accounts, not Instagram Personal accounts. `instagram` · **36 tools** · no triggers ## Connect it ```bash theme={"theme":"github-dark"} run auth instagram run auth instagram --scope team # shared with the organization ``` Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one. ## Use it ```bash theme={"theme":"github-dark"} run instagram # common commands run instagram --all # every command ``` ```ts theme={"theme":"github-dark"} import { instagram } from "@boxd/run"; ``` ## Common tools | Tool | What it does | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `create-carousel-container` | Create a draft carousel post with multiple images/videos before publishing. | | `create-media-container` | DEPRECATED: Use INSTAGRAM\_POST\_IG\_USER\_MEDIA instead. Creates a draft media container for photos/videos/reels before publishing. | | `create-post` | DEPRECATED: Use INSTAGRAM\_POST\_IG\_USER\_MEDIA\_PUBLISH instead. | | `get-ig-media` | Get a published Instagram Media object (photo, video, story, reel, or carousel). | | `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... | | `get-ig-media-insights` | Tool to get insights and metrics for Instagram media objects (photos, videos, reels, carousel albums). | | `get-ig-user-media` | Get Instagram user's media collection (posts, photos, videos, reels, carousels). | | `get-page-conversations` | Get Instagram conversations for a Page connected to an Instagram Business account. | | `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. | | `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. | | `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. | | `post-ig-user-media-publish` | Tool to publish a media container to an Instagram Business account. | | `send-text-message` | Send a text message to an Instagram user via DM in an existing conversation. | | `update-messenger-profile` | Tool to update the messenger profile settings for an Instagram account. | | Tool | What it does | | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `create-carousel-container` | Create a draft carousel post with multiple images/videos before publishing. | | `create-media-container` | DEPRECATED: Use INSTAGRAM\_POST\_IG\_USER\_MEDIA instead. Creates a draft media container for photos/videos/reels before publishing. | | `create-post` | DEPRECATED: Use INSTAGRAM\_POST\_IG\_USER\_MEDIA\_PUBLISH instead. | | `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. | | `delete-messenger-profile` | Delete ice breakers or a persistent menu from an Instagram messenger profile. | | `get-conversation` | Get details about a specific Instagram DM conversation (participants, etc). | | `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. | | `get-ig-media` | Get a published Instagram Media object (photo, video, story, reel, or carousel). | | `get-ig-media-children` | Tool to get media objects (images/videos) that are children of an Instagram carousel/album post. | | `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... | | `get-ig-media-insights` | Tool to get insights and metrics for Instagram media objects (photos, videos, reels, carousel albums). | | `get-ig-user-content-publishing-limit` | Get an Instagram Business Account's current content publishing usage. | | `get-ig-user-live-media` | Get live media objects during an active Instagram broadcast. | | `get-ig-user-media` | Get Instagram user's media collection (posts, photos, videos, reels, carousels). | | `get-ig-user-stories` | Get active story media objects for an Instagram Business or Creator account. | | `get-ig-user-tags` | Deprecated because the Instagram API with Instagram Login does not support tagging. | | `get-messenger-profile` | Get the messenger profile settings for an Instagram account. | | `get-page-conversations` | Get Instagram conversations for a Page connected to an Instagram Business account. | | `get-post-comments` | DEPRECATED: Use INSTAGRAM\_GET\_IG\_MEDIA\_COMMENTS instead. Get comments on an Instagram post. | | `get-post-insights` | DEPRECATED: Use INSTAGRAM\_GET\_IG\_MEDIA\_INSIGHTS instead. Get Instagram post insights/analytics (impressions, reach, engagement, etc.). | | `get-post-status` | DEPRECATED: Use GetIgMedia instead. Check the processing status of a draft post container. | | `get-user-info` | Get Instagram Business Account info including profile details and statistics. | | `get-user-insights` | Get Instagram account-level insights and analytics (profile views, reach, follower count, etc.). | | `get-user-media` | DEPRECATED: Use INSTAGRAM\_GET\_IG\_USER\_MEDIA instead. Get Instagram user's media (posts, photos, videos). | | `list-all-conversations` | List all Instagram DM conversations for the authenticated user. | | `list-all-messages` | List all messages from a specific Instagram DM conversation. | | `mark-seen` | Mark Instagram DM messages as read/seen for a specific user. | | `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. | | `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. | | `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. | | `post-ig-user-media-publish` | Tool to publish a media container to an Instagram Business account. | | `post-ig-user-mentions` | Tool to reply to a mention of your Instagram Business or Creator account. | | `reply-to-comment` | DEPRECATED: Use INSTAGRAM\_POST\_IG\_COMMENT\_REPLIES instead. Reply to a comment on Instagram media. | | `send-image` | Send an image via Instagram DM to a specific user. Each send modifies inbox state; avoid bulk or automated sends without explicit user approval. | | `send-text-message` | Send a text message to an Instagram user via DM in an existing conversation. | | `update-messenger-profile` | Tool to update the messenger profile settings for an Instagram account. | [Open Instagram in the console →](https://app.boxd.sh/integrations/detail/instagram)