OAuth providers

Instagram

Set up Instagram OAuth for business account data and media management

Overview

Connect your users to Instagram for business account data, media publishing, comment management, and insights — via the Meta Graph API.

Property	Value
Provider ID	`instagram`
Category	Social
PKCE	Supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create an Instagram OAuth App

Go to the Meta for Developers portal

Navigate to developers.facebook.com/apps and sign in. Instagram OAuth requires a Meta (Facebook) app.

Create a new app

Click Create App, select the Business use case or app type, and fill in the app details.

Configure OAuth redirect URIs

Under Use Cases, find Authentication and Account Creation, click Customize, then Go to Settings. Add the Alter callback URL from the Developer Portal to Valid OAuth Redirect URIs.

Get credentials

Go to Settings > Basic and copy the App ID (Client ID) and App Secret (Client Secret).

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Instagram provider

Go to OAuth Providers > Add Provider > Instagram.

Enter credentials

Client ID: Paste your Meta App ID
Client Secret: Paste your Meta App Secret

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
`instagram_basic`	Access to Instagram profile and media
`instagram_content_publish`	Publish media to Instagram
`instagram_manage_comments`	Read and reply to comments
`instagram_manage_insights`	Access account insights and metrics
`pages_show_list`	List connected Facebook Pages
`pages_read_engagement`	Read Page engagement data

Notes

Instagram OAuth requires the user’s Instagram account to be connected to a Facebook Page.
Some permissions require App Review before use in production.
See the Instagram API with Facebook Login documentation for more details.