Migrate your App
This guide will help you determine whether you should migrate your existing app to the new Instagram product and how to implement it.
Why migrate your app
The Instagram API with Instagram Login offers a streamlined and efficient way for your app users to manage their Instagram professional accounts without the need for a Facebook Page or Facebook presence. With only two permissions required for each functionality – instagram_business_basic and the permission specific to messaging, comment moderation, or content publishing – the onboarding process has been significantly simplified, going from an average of 12 steps to just two. As a result, we've seen a significant improvement in onboarding success rates.
Should you migrate your app
Use the following table to determine if you should implement the Instagram product into your app:
| Instagram API setup with Instagram Login | Instagram API setup with Facebook Logn | Instagram Messaging API (Messenger Platform) | |
|---|---|---|---|
| Access token type | Instagram User | Facebook User or Page | Facebook Page |
| Authorization type | Business Login for Instagram | Facebook Login for Business | Facebook Login for Business |
| Basic Instagram permission |
instagram_business_basic
|
instagram_basic
|
instagram_basic
|
| Comment moderation permission |
instagram_business_manage_comments
|
instagram_manage_comments
|
instagram_manage_comments
|
| Content publishing permission |
instagram_business_content_publish
|
instagram_content_publish
| |
| Facebook Page | Required | Required | |
| Hashtag feature | |||
| Human Agent feature | |||
| Insights permission |
instagram_manage_insights
| ||
| Mentions permission |
instagram_business_manage_comments
|
instagram_manage_comments
|
instagram_manage_comments
|
| Messaging permission |
instagram_business_manage_messages
|
instagram_manage_messages
|
Migration Steps
You will need to take the following steps to migrate your app.
Step 1. Add Instagram
Follow the
Create a Meta app with Instagram guide
to add the Instagram product to your existing business type app.
If your current Meta app type is not a Business type app you will need to create a new app and select Business during the creation process.
If this new app needs Advanced Access, App Review is required and will be handled within the Instagram product flow instead of the App Review item in the left side dashboard menu.
You will configure:
- Instagram Login for Business
- Permissions and features
- Webhooks
Step 2. Update your code
- Copy and paste the Embed URL in an anchor tag or button on your app or website to launch the Business Login for Instagram flow. This flow will give your app an Instagram User access token.
- Update the host URL in your code so that your API calls use
graph.instagram.com. - Update your API calls to use an Instagram User access token. This will update the
/meendpoint calls to use an Instagram Professional account ID instead of a Facebook Page ID - Replace your Meta app ID and app secret with the Instagram app ID and secret found in the app dashboard; Instagram > API setup with Instagram login > 3. Set up Instagram business login > Business login settings.