The Instagram OAuth Integration page is used to configure Instagram Business login and permissions for your platform. This allows users to connect their Instagram Business accounts to the platform and use Instagram-related automation and messaging features.
This setup is required before users can connect Instagram accounts from the Channels page.
Why This Is Required
Instagram integration requires Meta OAuth authentication. The platform needs approved Meta permissions to securely connect user Instagram accounts, access business profile data, receive messages, manage comments, and support publishing or insights features where enabled.
Without this configuration, users will not be able to connect Instagram accounts to the platform.
What This Enables
Once configured and approved, Instagram OAuth can support features such as Instagram account connection, message automation, comment management, content publishing, and insights access depending on the permissions approved by Meta.
The connected Instagram account can then be used inside the platform for communication, automation, and customer engagement workflows.
Required OAuth Scopes
These are the scopes the platform requests when a user connects Instagram:
instagram_business_basicinstagram_business_manage_messagesinstagram_business_manage_commentsinstagram_business_content_publishinstagram_business_manage_insights
Only request permissions that your platform actually uses. Requesting unnecessary permissions may increase the chance of rejection during Meta review.
Go to Meta for Developers and create a new app or open your existing platform app.
Use a business app type if your platform is used for business messaging, automation, or customer engagement.
Step 2: Add Instagram Product
Inside the Meta App dashboard, add the required Instagram product or configure Instagram Business Login based on the available Meta setup flow.
This connects your app with Instagram Business authentication.
Copy the Webhook Callback URL from your platform and add it inside the Meta webhook configuration.
This URL is used to receive Instagram-related webhook events such as messages, comments, or other supported updates.
Step 4: Set up Instagram business login
Meta may require additional URLs for compliance and data handling.
Add the following URLs from your platform where required:
- Deauthorize Callback URL
- Data Deletion Request URL
- OAuth redirect URIs
These URLs help Meta and users manage account disconnection and data deletion requests.
Step 5: Complete app review
Go to App Review and request the permissions listed in Required OAuth Scopes.
For each permission, provide a clear explanation of why the platform needs it and show the exact feature in your screencast video. Use the Review Submission Pack below.
Instagram OAuth permissions require Meta App Review before they can be used in production. Your app must clearly show how the permissions are used inside your platform.
Meta may ask for:
- valid business details
- privacy policy URL
- terms of service URL
- app domain verification
- clear use-case explanation
- screencast video showing the feature flow
- test login credentials, if required
Until the app is approved, Instagram login may work only for test users or app roles.
Review Submission Pack
1) App Use-Case Description (Copy-Paste)
Use this text when Meta asks:
“Please provide a detailed description of how your app uses the permission or feature requested, how it adds value for a person using your app, and why it’s necessary for app functionality.”
Overall Description
Our platform is a business messaging and automation product that helps companies manage Instagram conversations, post engagement, and publishing workflows from a shared team inbox. We request Instagram Business permissions so authenticated business users can connect their own Instagram account, manage interactions, and run approved automation in one place.
Each requested permission is tied to a visible user action in the platform (connect account, reply to messages, manage comments, publish approved content, and view insights). These permissions are required for core product behavior and are only used after user consent.
2) Scope-by-Scope Justification (Copy-Paste)
instagram_business_basic
Required to connect and identify the Instagram Business account selected by the user and show basic account information in the platform.
instagram_business_manage_messages
Required to receive and send Instagram direct messages from the platform inbox and automation flows.
Required to read, manage, and respond to comments and to trigger comment-based workflows requested by the business user.
instagram_business_content_publish
Required when users choose to publish approved posts from the platform to Instagram.
instagram_business_manage_insights
Required to retrieve account/content insights so users can analyze engagement and optimize campaign performance.
3) Screen Recording Checklist
Record one continuous flow (recommended 4-10 minutes):
- Show your platform domain and login.
- Open Platform Settings -> Instagram OAuth and show app is configured (mask secrets).
- Go to Channels/Connection page and click Connect Instagram.
- Complete Meta OAuth and grant requested permissions.
- Show connected Instagram account appears in your platform.
- Demonstrate each requested permission with an actual action:
- messages: receive/reply from inbox
- comments: view/respond to a post comment
- content publish: publish or schedule a test post (if requested)
- insights: open analytics/insights screen
- End by showing success state and where the user can disconnect access.
4) Upload Instructions
- Upload video to Google Drive (Anyone with link can view) or unlisted YouTube.
- In Meta App Dashboard, open App Review -> Permissions and Features.
- Open each requested permission and paste:
- use case description (from section above)
- exact test steps reviewer should follow
- video URL
- test credentials (if Meta asks)
- Ensure your app domain, privacy policy, and terms URLs are valid and publicly accessible before submission.
5) Pre-Submission Checklist
- App is in Live mode or fully ready for review testing.
- Privacy policy, terms URL, and app domain are reachable.
- Requested scopes exactly match the Required OAuth Scopes list above.
- Video demonstrates each requested scope with real UI actions.
- Reviewer steps and (if requested) test credentials are added for every permission request.
Common Recommendations
Make sure your app name, logo, privacy policy, terms URL, and domain are consistent across Meta and your platform.
Use a real business use case in your review explanation. Avoid vague descriptions such as “for testing” or “for integration”.
Request only the permissions that are actually used in your platform.
Ensure your platform has a working Instagram feature before submitting for review.
After Saving Settings
After saving Instagram OAuth settings in the platform, go to the Channels page and click Connect Instagram.
The popup login flow will use the saved Instagram OAuth configuration.
Important Notes
⚠️ Important Instagram OAuth will not work in production until the required Meta permissions are approved.
If permissions are missing, login may complete but features such as messages, comments, or insights may not work.
Last modified on August 7, 2026
