> ## 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 OAuth 2.0 (Instagram Login) connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 (Instagram Login) for Instagram in StackOne to allow users to link their accounts.

> [!WARNING]
>
> A professional Instagram account (Business or Creator) is required. Personal accounts are not supported. Your app must be published and pass App Review before users outside your app's roles can connect.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Create a Meta app

Create a Meta app with the Instagram use case. It provides the Instagram app credentials StackOne uses for Instagram Login.

**1. Sign in to Meta for Developers**

Sign in to your [Meta for Developers account](https://developers.facebook.com/apps).

<ul>
  <li>Open **My Apps** and click **Create App**.</li>
</ul>

![The Meta for Developers Apps page with the Create App button highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-create-app.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=9c2bcd322e5a15b8955c67fd7d589ac0)

**2. Enter app details**

On the **App details** step, enter an **App name** and confirm the **App contact email**.

<ul>
  <li>App name: `StackOne Integration`</li>
  <li>Click **Next**.</li>
</ul>

![The App details step with the App name field and the Next button highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-app-details.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=e927b9d59ac72aff466df33e7396a83e)

**3. Select the Instagram use case**

On the **Add use cases** step, select **Content management (5)** under **Filter by**.

<ul>
  <li>Select **Manage messaging & content on Instagram**.</li>
  <li>Click **Next**.</li>
</ul>

![The Add use cases step with Manage messaging & content on Instagram selected](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-use-case.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=1e212cafb9556a583414f9580aa713d2)

**4. Choose a business portfolio**

Under **Which business portfolio do you want to connect to this app?**, select your business portfolio, or **I don’t want to connect a business portfolio yet.**

<ul>
  <li>A verified business portfolio is required before you can publish the app.</li>
  <li>Click **Next**, then click **Next** again on the **Requirements** step.</li>
</ul>

![The Business step with the business portfolio options and the Next button highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-business.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=4ceeff9c403d0c76dc870f377065b50d)

**5. Create the app**

Review the **Overview** step and click **Create app**.

<ul>
  <li>Re-enter your Facebook password if prompted.</li>
</ul>

![The Overview step with the Create app button highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-create.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=ba62e6666d931dab39d0f9ffbb9b145b)

## Configure Instagram Login

Add the permissions StackOne needs and register the StackOne redirect URL for Instagram business login.

**1. Open the Instagram use case**

On the app **Dashboard**, click **Customize the Manage messaging & content on Instagram use case**.

![The app Dashboard with the Customize the Manage messaging & content on Instagram use case row highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-customize-use-case.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=6719b813fc1b9f739b702f180ccc2a4c)

**2. Add the required permissions**

On the **API setup with Instagram login** page, under **1. Add required messaging permissions**, click **Add all required permissions**.

![The API setup with Instagram login page with the Add all required permissions button highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-required-permissions.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=c67226199ac6f5e79060ada363701c5d)

**3. Add the remaining permissions**

Enables actions: Create Carousel Container, Create Carousel Item Container, Create Comment, Create Comment Reply, Create Ice Breakers, Create Media Container, Delete Comment, Delete Ice Breakers, Delete Persistent Menu, Display Sender Action, Get Account Insights, Get Comment, Get Comment Replies, Get Container Status, Get Content Publishing Limit, Get Conversation, Get Media, Get Media Children, Get Media Insights, Get Message, Get Persistent Menu, Get Profile, Get Story, Get Unified Credentials, List Comments, List Conversations, List Ice Breakers, List Media, List Stories, List Tagged Media, Publish Media, Reply To Mention, Send Message, Send Private Reply, Set Persistent Menu, Update Comment, Update Media

Click **Go to permissions and features** (or **Permissions and features** in the left menu) and click **Add** next to each permission this integration needs that is not yet **Ready for testing**:

![The Permissions and features page with the Add buttons for the publish, comments and insights permissions highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-permissions.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=14464e034e6f7debf5dc377c313e1ced)

<ul>
  <li>
    instagram\_business\_basic
  </li>

  <li>
    instagram\_business\_content\_publish
  </li>

  <li>
    instagram\_business\_manage\_comments
  </li>

  <li>
    instagram\_business\_manage\_insights
  </li>

  <li>
    instagram\_business\_manage\_messages
  </li>
</ul>

**4. Set up Instagram business login**

Return to **API setup with Instagram login** and, under **4. Set up Instagram business login**, click **Set up**.

![The Set up Instagram business login section with the Set up button highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-business-login.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=bd80371200474a7fad5cce8c0e7db714)

**5. Add the redirect URL**

In the **Set up Instagram business login** dialog, enter the StackOne callback in **Redirect URL**:

<ul>
  <li>Redirect URL: the **Callback URL** from your Connector Profile</li>
  <li>Click **Save**.</li>
  <li>The URL must match exactly, with no trailing slash.</li>
</ul>

![The Set up Instagram business login dialog with the Redirect URL field and Save button highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-redirect-url.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=a62d63312a74058f00086ce54fe7e947)

## Copy the Instagram app credentials

Instagram Login uses a dedicated Instagram app ID and secret, which differ from the App ID and App secret under **App settings** > **Basic**.

**1. Copy the Instagram app ID and secret**

In the left menu, open **API setup with Instagram login** and find the credentials panel under **Welcome to the Instagram API**.

<ul>
  <li>Copy the **Instagram app ID** and paste it into the **App ID** field in the StackOne Connector profile.</li>
  <li>Click **Show** next to **Instagram app secret**, verify your identity if prompted, copy the value, and paste it into the **App Secret** field in the StackOne Connector profile. Store it securely for use later.</li>
  <li>The **Scopes** field in the StackOne Connector profile is optional. Leave it blank to request all five permissions above, or enter a comma-separated subset.</li>
</ul>

![The Instagram app ID value and the Show button for the Instagram app secret highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/instagram_login-setup-credentials.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=cf2a8431449343052fe8c5a531e3e502)

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

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).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/instagram/guides/link-account/oauth-2-0-instagram-login.md).


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