> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram

> How to set up the Instagram connector, plus the actions that are available.

![Instagram](https://stackone-logos.com/api/instagram/filled/svg)

Previewv2.1.0[See changelog](https://docs.stackone.com/connectors/instagram/changelog.md)

[83 actions](#actions) · 2 auth methods

Marketing
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 (Instagram Login) · Connector Profile](https://docs.stackone.com/connectors/instagram/guides/connector-profile/oauth-2-0-instagram-login.md)
>
> Simpler setup for content publishing, comments, and messaging. Requires a professional Instagram account.

> [card] [OAuth 2.0 (Facebook Login) · Connector Profile](https://docs.stackone.com/connectors/instagram/guides/connector-profile/oauth-2-0-facebook-login.md)
>
> Provides additional access to insights and shopping features. Requires Instagram account linked to a Facebook Page.

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 (Instagram Login) · Link Account](https://docs.stackone.com/connectors/instagram/guides/link-account/oauth-2-0-instagram-login.md)

> [card] [OAuth 2.0 (Facebook Login) · Link Account](https://docs.stackone.com/connectors/instagram/guides/link-account/oauth-2-0-facebook-login.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

OAuth 2.0 (Facebook Login)

OAuth 2.0 (Instagram Login)

No auth methods found

Scopes

Select all
|
Clear

instagram\_basic

instagram\_business\_basic

instagram\_business\_content\_publish

instagram\_business\_manage\_comments

instagram\_business\_manage\_insights

instagram\_business\_manage\_messages

instagram\_content\_publish

instagram\_manage\_comments

instagram\_manage\_contents

instagram\_manage\_insights

instagram\_shopping\_tag\_products

No scopes found

83 actions

ActionDescriptionRequired scopes

List Catalogs`instagram_list_catalogs`

List all product catalogs connected to the Instagram Business Account.

`instagram_shopping_tag_products`

Search Catalog Products`instagram_search_catalog_products`

Search for products in a connected Instagram Shopping catalog.

`instagram_shopping_tag_products`

Get Product Tags`instagram_get_product_tags`

Get all product tags on a specific Instagram media object.

`instagram_shopping_tag_products`

Create Or Update Product Tags`instagram_create_or_update_product_tags`

Add or update product tags from a connected catalog on an Instagram media object.

`instagram_shopping_tag_products`

Create Product Appeal`instagram_create_product_appeal`

Appeal the rejection of a product in the connected Instagram Shop catalog.

`instagram_shopping_tag_products`

Get Product Appeal`instagram_get_product_appeal`

Get the review and appeal status of a product in the connected Instagram Shop catalog.

`instagram_shopping_tag_products`

List Comments`instagram_list_comments`

List all comments on a specific Instagram media object.

`instagram_business_manage_comments`

Get Comment`instagram_get_comment`

Get details of a specific comment by its ID.

`instagram_business_manage_comments`

Create Comment`instagram_create_comment`

Post a top-level comment on an Instagram media object.

`instagram_business_manage_comments`

Update Comment`instagram_update_comment`

Hide or unhide a comment on an Instagram media object.

`instagram_business_manage_comments`

Delete Comment`instagram_delete_comment`

Permanently delete a comment from an Instagram media object.

`instagram_business_manage_comments`

Create Comment Reply`instagram_create_comment_reply`

Reply to a top-level comment on an Instagram media object.

`instagram_business_manage_comments`

Get Comment Replies`instagram_get_comment_replies`

List the replies to a specific Instagram comment.

`instagram_business_manage_comments`

List Comments (Facebook Login)`instagram_fb_list_comments`

List all comments on a specific Instagram media object using Facebook Login.

`instagram_manage_comments`

Get Comment (Facebook Login)`instagram_fb_get_comment`

Get details of a specific comment by its ID using Facebook Login.

`instagram_manage_comments`

Create Comment (Facebook Login)`instagram_fb_create_comment`

Post a top-level comment on an Instagram media object using Facebook Login.

`instagram_manage_comments`

Update Comment (Facebook Login)`instagram_fb_update_comment`

Hide or unhide a comment on an Instagram media object using Facebook Login.

`instagram_manage_comments`

Delete Comment (Facebook Login)`instagram_fb_delete_comment`

Permanently delete a comment from an Instagram media object using Facebook Login.

`instagram_manage_comments`

Create Comment Reply (Facebook Login)`instagram_fb_create_comment_reply`

Reply to a top-level comment on an Instagram media object using Facebook Login authentication.

`instagram_manage_comments`

Get Comment Replies (Facebook Login)`instagram_fb_get_comment_replies`

List the replies to a specific Instagram comment using Facebook Login authentication.

`instagram_manage_comments`

Get Business Discovery`instagram_get_business_discovery`

Look up public profile information for another Instagram Business or Creator account.

`instagram_basic`

Search Hashtag`instagram_search_hashtag`

Find the ID for a specific Instagram hashtag.

`instagram_basic`

List Hashtag Recent Media`instagram_list_hashtag_recent_media`

Get the most recent public media posts for a specific hashtag.

`instagram_basic`

List Hashtag Top Media`instagram_list_hashtag_top_media`

Get the top-performing public media posts for a specific hashtag.

`instagram_basic`

Get Hashtag`instagram_get_hashtag`

Get the name of an Instagram hashtag by its ID.

`instagram_basic`

List Recently Searched Hashtags`instagram_list_recently_searched_hashtags`

List the hashtags the account has searched in the last 7 days.

`instagram_basic`

Get Unified Credentials`instagram_unified_get_me`

Get the current Instagram connection's unified credentials and identity.

`instagram_business_basic``instagram_basic`

Get Account Insights`instagram_get_account_insights`

Get analytics and performance insights for the authenticated Instagram account.

`instagram_business_manage_insights`

Get Media Insights`instagram_get_media_insights`

Get engagement analytics for a specific Instagram media object.

`instagram_business_manage_insights`

Get Account Insights (Facebook Login)`instagram_fb_get_account_insights`

Get analytics and performance insights for the Instagram Business Account using Facebook Login.

`instagram_manage_insights`

Get Media Insights (Facebook Login)`instagram_fb_get_media_insights`

Get engagement analytics for a specific Instagram media object using Facebook Login.

`instagram_manage_insights`

List Media`instagram_list_media`

List all media objects published on the authenticated Instagram account.

`instagram_business_basic`

Get Media`instagram_get_media`

Get details of a specific media object by its ID.

`instagram_business_basic`

Create Media Container`instagram_create_media_container`

Create a media container as the first step of the two-step publishing process.

`instagram_business_content_publish`

Create Carousel Item Container`instagram_create_carousel_item_container`

Create a container for a single item within a carousel post.

`instagram_business_content_publish`

Create Carousel Container`instagram_create_carousel_container`

Create a carousel container from previously created item containers.

`instagram_business_content_publish`

Publish Media`instagram_publish_media`

Publish a media container to the Instagram account feed.

`instagram_business_content_publish`

Get Container Status`instagram_get_container_status`

Check the processing status of a media container before publishing.

`instagram_business_content_publish`

List Media (Facebook Login)`instagram_fb_list_media`

List all media objects published on the Instagram Business Account using Facebook Login.

`instagram_basic`

Get Media (Facebook Login)`instagram_fb_get_media`

Get details of a specific media object by its ID using Facebook Login.

`instagram_basic`

Delete Media (Facebook Login)`instagram_fb_delete_media`

Delete a media object from the Instagram Business Account using Facebook Login.

`instagram_manage_contents`

Create Media Container (Facebook Login)`instagram_fb_create_media_container`

Create a media container as the first step of publishing via Facebook Login.

`instagram_content_publish`

Create Carousel Item Container (Facebook Login)`instagram_fb_create_carousel_item_container`

Create a container for a single carousel item using Facebook Login.

`instagram_content_publish`

Create Carousel Container (Facebook Login)`instagram_fb_create_carousel_container`

Create a carousel container from item containers using Facebook Login.

`instagram_content_publish`

Publish Media (Facebook Login)`instagram_fb_publish_media`

Publish a media container to the Instagram Business Account feed using Facebook Login.

`instagram_content_publish`

Get Container Status (Facebook Login)`instagram_fb_get_container_status`

Check the processing status of a media container using Facebook Login.

`instagram_content_publish`

Update Media`instagram_update_media`

Turn comments on or off for an Instagram media object.

`instagram_business_manage_comments`

Update Media (Facebook Login)`instagram_fb_update_media`

Turn comments on or off for an Instagram media object using Facebook Login.

`instagram_manage_comments`

Get Content Publishing Limit`instagram_get_content_publishing_limit`

Get how many posts the account has published against its 24-hour publishing limit.

`instagram_business_content_publish`

Get Content Publishing Limit (Facebook Login)`instagram_fb_get_content_publishing_limit`

Get how many posts the account has published against its 24-hour publishing limit using Facebook Login.

`instagram_content_publish`

Get Media Children`instagram_get_media_children`

List the individual images and videos inside a carousel media object.

`instagram_business_basic`

Get Media Children (Facebook Login)`instagram_fb_get_media_children`

List the individual images and videos inside a carousel media object using Facebook Login.

`instagram_basic`

List Media Collaborators (Facebook Login)`instagram_fb_list_media_collaborators`

List the collaborators invited to an Instagram media object and their invitation status using Facebook Login.

`instagram_basic`

Fetch Collaboration Invites (Facebook Login)`instagram_fb_fetch_collaboration_invites`

List pending invitations for the account to collaborate on other users' posts using Facebook Login.

`instagram_basic`

Respond To Collaboration Invite (Facebook Login)`instagram_fb_respond_to_collaboration_invite`

Accept or decline a pending collaboration invite using Facebook Login.

`instagram_basic`

List Collaborative Media (Facebook Login)`instagram_fb_list_collaborative_media`

List posts by other users on which the account is an accepted collaborator using Facebook Login.

`instagram_basic`

Search Collaborative Media (Facebook Login)`instagram_fb_search_collaborative_media`

Get a post by another user on which the account is an accepted collaborator using Facebook Login.

`instagram_basic`

List Live Media (Facebook Login)`instagram_fb_list_live_media`

List live videos the Instagram Business Account is broadcasting right now using Facebook Login.

`instagram_basic`

Upload Container Video (Facebook Login)`instagram_fb_upload_container_video`

Upload a hosted video into a resumable media container using Facebook Login.

`instagram_content_publish`

List Tagged Media`instagram_list_tagged_media`

List media objects where the authenticated Instagram account has been tagged.

`instagram_business_basic`

List Tagged Media (Facebook Login)`instagram_fb_list_tagged_media`

List media objects where the Instagram Business Account has been tagged, using Facebook Login.

`instagram_basic`

Get Mentioned Media (Facebook Login)`instagram_fb_get_mentioned_media`

Get data about a specific media object where the Instagram Business Account was @mentioned, using Facebook Login.

`instagram_basic`

Reply To Mention (Facebook Login)`instagram_fb_reply_to_mention`

Comment on a post or comment in which another user @mentioned the account using Facebook Login.

`instagram_manage_comments`

Get Mentioned Comment (Facebook Login)`instagram_fb_get_mentioned_comment`

Get a comment in which another user @mentioned the account using Facebook Login.

`instagram_basic`

Reply To Mention`instagram_reply_to_mention`

Comment on a post or comment in which another user @mentioned the account.

`instagram_business_manage_comments`

Send Message`instagram_send_message`

Send a direct message to an Instagram user.

`instagram_business_manage_messages`

List Conversations`instagram_list_conversations`

List all direct message conversations for the authenticated Instagram account.

`instagram_business_manage_messages`

Get Conversation`instagram_get_conversation`

Get messages in a specific direct message conversation.

`instagram_business_manage_messages`

Send Private Reply`instagram_send_private_reply`

Send a private direct message to a person who commented on the account's media.

`instagram_business_manage_messages`

Get Message`instagram_get_message`

Get the content and sender of a specific direct message.

`instagram_business_manage_messages`

Display Sender Action`instagram_display_sender_action`

Show a typing indicator or mark messages as seen in a direct message conversation.

`instagram_business_manage_messages`

List Ice Breakers`instagram_list_ice_breakers`

Get the ice breaker questions shown when a person starts a conversation with the account.

`instagram_business_manage_messages`

Create Ice Breakers`instagram_create_ice_breakers`

Set the ice breaker questions shown when a person starts a conversation with the account.

`instagram_business_manage_messages`

Delete Ice Breakers`instagram_delete_ice_breakers`

Remove all ice breaker questions from the account's messaging profile.

`instagram_business_manage_messages`

Get Persistent Menu`instagram_get_persistent_menu`

Get the persistent menu shown in the account's direct message conversations.

`instagram_business_manage_messages`

Set Persistent Menu`instagram_set_persistent_menu`

Set the persistent menu shown in the account's direct message conversations.

`instagram_business_manage_messages`

Delete Persistent Menu`instagram_delete_persistent_menu`

Remove the persistent menu from the account's direct message conversations.

`instagram_business_manage_messages`

Get Profile`instagram_get_profile`

Get the authenticated Instagram account's profile information.

`instagram_business_basic`

Get Profile (Facebook Login)`instagram_fb_get_profile`

Get the Instagram Business Account profile information using Facebook Login.

`instagram_basic`

List Stories`instagram_list_stories`

List active stories on the authenticated Instagram account.

`instagram_business_basic`

Get Story`instagram_get_story`

Get details of a specific story by its ID.

`instagram_business_basic`

List Stories (Facebook Login)`instagram_fb_list_stories`

List active stories on the Instagram Business Account using Facebook Login.

`instagram_basic`

Get Story (Facebook Login)`instagram_fb_get_story`

Get details of a specific story by its ID using Facebook Login.

`instagram_basic`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.