Connect Instagram
OAuth your Instagram Business or Creator account via Instagram Login.
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
- Instagram account is Business or Creator:
- Instagram app → Profile → ☰ → Settings → Account → Switch account type.
- You are signed in to that Instagram account in your browser (or ready to sign in inside the OAuth popup).
Connect
- Project Settings → Social accounts → Connect Instagram.
- An Instagram OAuth window opens at
instagram.com/oauth/authorize. - Sign in to Instagram (or confirm the active session).
- Approve the requested scopes.
- The window closes and the account appears in your connected list.
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
Instagram long-lived tokens last 60 days. Tokens are stored encrypted in the Layers credential vault and periodically refreshed. If a refresh fails, the account is marked unhealthy and you'll be prompted to reconnect.
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
Story publishing is not currently supported by Layers' scheduler.
Disconnecting
Project Settings → Social accounts → row → Disconnect.
Troubleshooting
- "Account not eligible" — Instagram is Personal; switch to Business or Creator.
- Token refresh failures — reconnect from the Social accounts page.