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

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

> [!WARNING]
>
> A professional Instagram account (Business or Creator) linked to a Facebook Page is required, and you need admin access to both the Facebook Page and the Meta app. 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. Facebook Login for Business is added to the app automatically.

**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/facebook_login-setup-create-app.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=9b981840c483a1ace3967be88d886405)

**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/facebook_login-setup-app-details.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=2437037dcd913959aad09218acc07238)

**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/facebook_login-setup-use-case.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=eeba1888c6c7673650de5cf59f106649)

**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/facebook_login-setup-business.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=d968049294434318a13b4babcf3aa67c)

**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/facebook_login-setup-create.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=196ddcea39bd299e37638b1d09a3382a)

## Add the Instagram permissions

Add the permissions StackOne requests through Facebook Login for Business.

**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/facebook_login-setup-customize-use-case.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=e2f3917689e22ef7def1dae9ef0c6bf2)

**2. Add the required content permissions**

In the left menu, open **API setup with Facebook login** and, under **Manage content on Instagram**, click **Add required content permissions**.

<ul>
  <li>This adds **instagram\_basic**, **pages\_read\_engagement**, **business\_management** and **pages\_show\_list**, plus the content publishing permission.</li>
</ul>

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

**3. Add the remaining permissions**

Enables actions: Create Carousel Container (Facebook Login), Create Carousel Item Container (Facebook Login), Create Comment (Facebook Login), Create Comment Reply (Facebook Login), Create Media Container (Facebook Login), Create Or Update Product Tags, Create Product Appeal, Delete Comment (Facebook Login), Delete Media (Facebook Login), Fetch Collaboration Invites (Facebook Login), Get Account Insights (Facebook Login), Get Business Discovery, Get Comment (Facebook Login), Get Comment Replies (Facebook Login), Get Container Status (Facebook Login), Get Content Publishing Limit (Facebook Login), Get Hashtag, Get Media (Facebook Login), Get Media Children (Facebook Login), Get Media Insights (Facebook Login), Get Mentioned Comment (Facebook Login), Get Mentioned Media (Facebook Login), Get Product Appeal, Get Product Tags, Get Profile (Facebook Login), Get Story (Facebook Login), Get Unified Credentials, List Catalogs, List Collaborative Media (Facebook Login), List Comments (Facebook Login), List Hashtag Recent Media, List Hashtag Top Media, List Live Media (Facebook Login), List Media (Facebook Login), List Media Collaborators (Facebook Login), List Recently Searched Hashtags, List Stories (Facebook Login), List Tagged Media (Facebook Login), Publish Media (Facebook Login), Reply To Mention (Facebook Login), Respond To Collaboration Invite (Facebook Login), Search Catalog Products, Search Collaborative Media (Facebook Login), Search Hashtag, Update Comment (Facebook Login), Update Media (Facebook Login), Upload Container Video (Facebook Login)

In the left menu, open **Permissions and features** 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 instagram\_manage\_contents and instagram\_manage\_insights highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/facebook_login-setup-permissions.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=4f5169f18eb035d5ec08d09d13427a65)

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

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

  <li>
    instagram\_manage\_contents
  </li>

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

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

  <li>
    instagram\_shopping\_tag\_products
  </li>
</ul>

## Configure the redirect URI

Register the StackOne callback with Facebook Login for Business.

**1. Add the redirect URI**

In the left menu, open **Facebook Login for Business** > **Settings**. Under **Client OAuth settings**, enter the StackOne callback in **Valid OAuth Redirect URIs** and press Enter.

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

![The Valid OAuth Redirect URIs field with the StackOne callback added](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/facebook_login-setup-redirect-uri.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=2f9da5c0abd50d0c88b9f2c90bc0ce46)

**2. Save the settings**

Scroll to the bottom of the page and click **Save Changes**.

![The bottom of the Facebook Login for Business settings page with the Save Changes button highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/facebook_login-setup-save-changes.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=f355ea22bb5d298358c691d109431c3e)

## Copy the App ID and App secret

Facebook Login uses the app's own credentials from its basic settings.

**1. Copy the credentials**

In the left menu, open **App settings** > **Basic**.

<ul>
  <li>Copy the **App ID** and paste it into the **App ID** field in the StackOne Connector profile.</li>
  <li>Click **Show** next to **App secret**, re-enter your Facebook password 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 the default Instagram and Pages permissions, or enter a comma-separated subset.</li>
</ul>

![The App settings Basic page with the App ID field and the Show button for App secret highlighted](https://mintcdn.com/stackone-60/D6RKT3xhDHhVXazO/connectors/instagram/images/facebook_login-setup-credentials.png?fit=max\&auto=format\&n=D6RKT3xhDHhVXazO\&q=85\&s=0933aa7178d0441924c9898c6eb7a16c)

## 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-facebook-login.md).


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