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 Permissions
You must request the permissions that match the Instagram features used by your platform.
Common permissions include:
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.
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.
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 3: 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 4: Complete app review
Go to App Review and request the required Instagram permissions.
For each permission, provide a clear explanation of why the platform needs it and show the exact feature in your screencast video.
Permission Justification Examples
instagram_business_basic
Our platform uses this permission to allow businesses to connect their Instagram Business account and display basic account information inside the platform.
instagram_business_manage_messages
Our platform uses this permission to allow businesses to receive and respond to Instagram messages from a shared inbox and automation workflows.
Our platform uses this permission to help businesses manage comments on Instagram posts and trigger automation based on comment activity.
instagram_business_content_publish
Our platform uses this permission to allow businesses to publish approved Instagram content through the platform.
instagram_business_manage_insights
Our platform uses this permission to show Instagram performance insights and help businesses understand engagement and account activity.
Screencast Video Requirement
For Meta review, you should provide a clear video showing the complete Instagram integration flow.
The video should show:
- your platform domain
- login to your platform
- opening Instagram connection settings or Channels page
- clicking Connect Instagram
- completing Instagram OAuth login
- granting permissions
- connected Instagram account appearing in the platform
- the feature that uses the requested permission
The video should be simple, clear, and preferably include voice explanation or captions.
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 April 24, 2026
