Instagram Integration
Instagram APP_ID and APP_SECRET Setup (Unified Login)
Switch to a professional account, configure Unified Login for a new integration, and find your Meta app ID, secret and Configuration ID.
Open Meta developer app console1. Switch Instagram to a professional account
Unified Login requires a professional account: business or creator. If you already have either type, continue to the next section.
- Sign in to the Instagram account you want to connect. Open your profile at the bottom right, then open the menu at the top right.
- In Settings and activity, find For professionals and open Account type and tools. Menu labels may vary by app version and language.
- Select Switch to professional account and choose a category that describes your account.
- Choose your type: Business suits shops, brands and services; Creator suits content creators, artists and influencers. Both are professional accounts.
- Review contact details and profile display settings and finish the switch. Check for the Professional dashboard on your profile and business or creator tools in settings.
On a computer, sign in at instagram.com and open More > Settings > Account type and tools > Switch to professional account. Choose your category and Business or Creator, then complete the on-screen setup.
Official documentation: Set up an Instagram professional account
2. Credentials to prepare
Use the Meta app’s values for APP_ID and APP_SECRET. You also need the login configuration identifier, config_id. Account IDs and access tokens are separate values.
| Handover item | Value to copy | Where to find it |
|---|---|---|
| APP_ID | Meta app App ID | App settings > Basic > App ID |
| APP_SECRET | App Secret from the same Meta app | App settings > Basic > App Secret |
| config_id | Login configuration’s Configuration ID | The selected configuration in API setup with Unified login > Configure your app |
Official documentation: Instagram platform and access levels · Unified Login authentication credentials
3. Before creating your Meta app
- Prepare a Meta developer account controlled by your service owner and a working contact email. Complete developer registration and any requested verification.
- You need a business portfolio that owns the app and an app admin role. Have your Instagram professional account ready.
- Get the exact HTTPS Redirect URL, required features and permissions, and service, privacy policy and data-deletion URLs from your developer. Do not invent these addresses.
4. Configure Unified Login and find credentials
Create a Meta developer app
Open My Apps > Create App in the console above. Enter the service app name and contact email and connect the business portfolio that will own the app.
Open the Instagram use case
Create the app with the Manage messaging & content on Instagram use case. Open Use cases > that use case > Customize > API setup with Unified login.
Create a login configuration
Open Configure your app > Create new configuration. Agree on required permissions with your developer, adjust them in Edit permissions, then select Use this configuration. Copy its Configuration ID (config_id).
Save the redirect address and copy the login URL
Enter the HTTPS address supplied by your developer in the selected configuration’s Redirect URL and select Save. Copy the generated Login URL and share it with config_id.
Copy the Meta app ID and secret
Open App settings > Basic and copy the complete App ID and App Secret. The account owner completes any authentication needed to reveal the secret. Your developer sets these as APP_ID and APP_SECRET on the server.
Official documentation: Set up Unified Login · Unified Login authentication credentials
4-1. Add permissions and obtain approval
The current features are publishing, comments, DMs and insights. This service connects Instagram accounts through Facebook Pages after Unified Login. For this implementation, eight permissions are required; business_management can be excluded from the initial review.
| Permission | Required? | Reason |
|---|---|---|
instagram_basic | Required | Read basic account information and posts. |
instagram_content_publish | Required | Automatically publish posts and stories. |
instagram_manage_comments | Required | Automatically reply to comments. |
instagram_manage_messages | Required | Send automated DMs. |
instagram_manage_insights | Required | Retrieve account and post metrics for the analytics screen. |
pages_show_list | Required | The current service finds linked Instagram accounts through the Facebook Page list, so this is needed to connect accounts. |
pages_read_engagement | Required | Satisfy permission dependencies for comments, DMs and insights in the current Page-based integration. |
pages_manage_metadata | Required | Subscribe to Page webhooks that deliver comment and DM notifications to the server in the current implementation. |
business_management | Can be excluded | Unused by the current features, so omit it from the initial application to reduce review scope. Reassess if direct business asset discovery or management without Pages is needed. |
- Open the configuration under API setup with Unified login > Configure your app. Add the eight required permissions above in Edit permissions, exclude business_management from the initial application, select Use this configuration and give its config_id to your developer.
- For external clients without an app role, obtain Advanced Access for each required permission through App Review. Complete the use-case explanation, test instructions, demonstrations and Business Verification requested by the console, then meet Live mode requirements.
- After approval, check the permissions requested by the login configuration and actually granted by the user and token. If an existing connection needs added permissions, repeat authorization to obtain consent.
Official documentation: Unified Login permissions and approval · Meta Page and business permissions
5. Check redirect and webhook settings
- The Redirect URL returns people to your service after authorization. HTTPS, domain, path and trailing slash must match the actual login request. Distinguish saved development and production addresses in your handover.
- In Configure webhooks, enter and verify the separate Callback URL and Verify token supplied by your developer. Subscribe to required events; your developer also checks per-account subscriptions after connection. Webhook and OAuth redirect addresses serve different purposes.
- Save the app details, privacy policy, data-deletion information and any other items required by the current console.
6. Test and prepare public access
- Under Generate access tokens > Add account, add the Instagram professional account for testing. Accept the invitation on Instagram web under Settings > Website permissions > Apps and websites > Tester Invites, then use Generate token to obtain a test token.
- With your developer, test the Login URL, business portfolio and Instagram account selection, permission consent and webhook delivery. A test token is separate from APP_SECRET; check expiration settings in the configuration.
- Distinguish Standard Access for app-role users from Advanced Access for external clients. Before connecting clients, complete Advanced Access for required permissions, App Review, Business Verification and Live mode requirements.
Official documentation: Instagram platform and access levels · Set up Unified Login
7. What to send your developer
- App name, complete Meta app App ID (APP_ID) and App Secret (APP_SECRET), Configuration ID (config_id), and the generated Login URL.
- Saved Redirect URLs, development/production distinction, connected Instagram account and business portfolio, and requested and approved permissions.
- Tester invitation acceptance, app mode, Business Verification and App Review status. Hide secrets in screenshots shared for configuration checks.
Missing settings or a failed connection?
- Switch option missing: check whether the account is already Business or Creator, then check Account type and tools or the corresponding professional tools menu.
- Unified Login tab missing: check business portfolio ownership, your app admin role and Facebook Login for Business configuration. Unified Login is built on that feature.
- Authorization fails: check that APP_ID and APP_SECRET belong to the same Meta app, config_id identifies its selected configuration, and the Redirect URL matches the saved address.
Documentation checked November 22, 2026. Menu labels may vary by app version and language. Instagram Help may require sign-in.