# Connect Instagram (/docs/social/connect-instagram)



Instagram is connected via **Instagram Login** (`instagram.com/oauth`) —
not Facebook Login. A Facebook Page link is **not required**. Personal
Instagram accounts are not eligible; you must be on a Business or
Creator account.

## Prerequisites [#prerequisites]

1. Instagram account is **Business** or **Creator**:
   * Instagram app → Profile → ☰ → Settings → Account → **Switch account
     type**.
2. You are signed in to that Instagram account in your browser (or ready
   to sign in inside the OAuth popup).

## Connect [#connect]

1. Project Settings → **Social accounts** → **Connect Instagram**.
2. An Instagram OAuth window opens at `instagram.com/oauth/authorize`.
3. Sign in to Instagram (or confirm the active session).
4. Approve the requested scopes.
5. The window closes and the account appears in your connected list.

## Scopes requested [#scopes-requested]

* `instagram_business_basic` — read the profile and posts.
* `instagram_business_content_publish` — publish posts and Reels.
* `instagram_business_manage_insights` — read post and account insights.
* `instagram_business_manage_comments` — read and reply to comments.

These are the minimum required for generation, publishing, metrics, and
engagement. Layers does not request DM, Pages, or ads scopes here.

## Token expiry [#token-expiry]

Instagram long-lived tokens last 60 days. Tokens are stored encrypted
in the [Layers credential vault](/docs/trust/vault) and periodically
refreshed. If a refresh fails, the account is marked unhealthy and
you'll be prompted to reconnect.

## Posting [#posting]

Publishing happens via Instagram Graph API (`graph.instagram.com`). In
automatic mode the post is published directly to the feed when its
scheduled slot arrives. In manual mode it sits in the pending-manual
queue for you to approve first.

## Stories [#stories]

Story publishing is not currently supported by Layers' scheduler.

## Disconnecting [#disconnecting]

Project Settings → Social accounts → row → **Disconnect**.

## Troubleshooting [#troubleshooting]

* **"Account not eligible"** — Instagram is Personal; switch to Business
  or Creator.
* **Token refresh failures** — reconnect from the Social accounts page.