App Review for Instagram API

Your app must complete App Review before it can request permissions with Advanced Access from any app user and features with Advanced Access are active for all app users.

Development scenarios

The following table contains the possible development scenarios and the corresponding App Review requirements.

Development scenarioLogin typeAccess levelApp Review

My app is only for a business I own or manage.

No login or Instagram Login

Standard Access

Not required

My app is only for a business I own or manage.

No login or Facebook Login

Standard Access

Not required

I am a Tech Provider and my app serves multiple businesses.

Instagram Login

Advanced Access

Required

I am a Tech Provider and my app serves multiple businesses.

Facebook Login

Advanced Access

Required

Available permissions & features

The permissions and features you can request Advanced Access for are dependent on the login type.

Your app can either use Facebook Login or Instagram Login but not both.

Instagram API with Facebook Login


  • Human Agent
  • Instagram Public Content Access
  • ads_management
  • business_management
  • catalog_management
  • instagram_basic
  • instagram_branded_content_ads_brand
  • instagram_branded_content_brand
  • instagram_branded_content_creator
  • instagram_content_publishing
  • instagram_manage_comments
  • instagram_manage_events
  • instagram_manage_insights
  • instagram_manage_messages
  • instagram_manage_upcoming_events
  • instagram_shopping_tag_products
  • pages_read_engagement
  • pages_show_list

Instagram API with Instagram Login


  • Human Agent
  • instagram_business_basic
  • instagram_business_content_publishing
  • instagram_business_manage_comments
  • instagram_business_manage_messages

Migrated apps

If you are migrating your app to Instagram API with Instagram Login from Instagram API with Facebook Login, your app might automatically be granted Advanced Access for the corresponding Instagram API permission and App Review isn't required.

If your app is not automatically granted Advanced Access, then you will need to submit for App Review.

Instagram API with Facebook LoginInstagram API with Instagram Login

instagram_basic

instagram_business_basic

instagram_content_publishing

instagram_business_content_publishing

instagram_manage_comments

instagram_business_manage_comments

instagram_manage_messages

instagram_business_manage_messages

If you need to submit for App Review you must follow the instructions in the Start a submission section below. The submission flow in the App Dashboard has changed.

Start a submission

To submit for App Review, go to the App Dashboard.

  1. In the left-side menu under Products, go to Instagram > API setup with Instagram login.
  2. Click the chevron in the upper right corner of the Complete app review section.
  3. Review the permissions and features you are requesting Advanced Access for and click Continue to app review. You'll be redirected to App Review > Requests in the dashboard.
  4. Click the Edit button to trigger the review flow.

Request for App Review

You will see a list of action items that are required. These include the following:

  • Confirm that your app can be loaded and tested externally
  • Verify that the login button or link is visible in your app and screencast, and adheres to our brand guidelines
  • Provide clear use case details and describe step-by-step how a person uses your app Tell us how your use of each permission you have requested follows established usage guidelines
  • To request Advanced Access to certain permissions, you need to make at least 1 successful API call

Complete App Settings

Add or upate your app's settings.

Click the Review your app settings to add or update the following:

  1. App icon (1024x1024) – The icon for your app
  2. Privacy Policy URL – The privacy policy URL that your app users can visit to view your privacy policy
  3. App Category – The app category that best represents your app's functionality
  4. Business Email – The email, set in your Developer Settings, where App Review results and developer alert emails are sent

Complete App Verification

Provide detailed instructions for Meta app reviwers to log in and test your app.

Click Provide verification details to provide detailed step-by-step instructions, for each platform on which your app is available, for Meta app reviewers so they can log in to your app to test your integration and how you are using each permission and feature.

  1. Platform Settings
    • Provide detailed step-by-step instructions for Meta reviewers to log in and test your app on each platform, Android, iOS, Web, and so on, on which your app is available. Be specific about when and how your app uses each permission and feature and how a reviewer can test each usage.
  2. Credentials (If applicable)
    • If needed, provide any required test credentials for Meta reviewers to log into your app or website.

NOTE: Web or mobile Web is the only platform that currently supports Instagram API with Instagram Login.

Permission & feature requests

Provide a description for how your app uses a specific permission and include a screencast showing this usage.

Click the arrow icon to the right of each How will your app use question for each permission or feature that you have requested. You will be asked to:

  • Describe how your app uses that specific permission or feature
  • Upload a screencast showing the end-to-end user experience for that specific permission or feature. The screencast only needs to showcase how your app is using that permission or feature.
  • Agree that you will comply with the allowed usage for that permission or feature.
  • If a permission or feature is dependent on another permission, you must include this permission in your submission.

If you request permissions or features that your app does not use or does not align with the allowed usage for that permission or feature, your submission will not be approved.

Screencast guidance

لضمان وصول جميع مراجعينا إلى تسجيل الشاشة، يُرجى اتِّباع هذه الإرشادات:
  • استخدام اللغة الإنجليزية كلغة واجهة مستخدم التطبيق – يُرجى تعيين اللغة الإنجليزية كلغة واجهة مستخدم التطبيق قبل التقاط تسجيل الشاشة، إن أمكن. وسيؤدي ذلك إلى تسهيل فهم محتوى تطبيقك على فريق المراجعة.
  • تقديم شروح توضيحية ونصائح بشأن الأدوات - إذا لم يكن تطبيقك متاحًا باللغة الإنجليزية، أو إذا كان هناك أي أجزاء من التطبيق غير واضحة، فيُرجى تقديم شروح توضيحية ونصائح بشأن الأدوات لشرح ما يحدث على الشاشة. سيساعد ذلك فريق المراجعة على فهم ما تعرضه وطريقة عمل التطبيق.
  • شرح معنى الأزرار وعناصر واجهة المستخدم الأخرى - يُرجى استغراق الوقت اللازم لشرح معنى أي أزرار أو عناصر واجهة المستخدم الأخرى التي قد تكون غير واضحة من الوهلة الأولى. سيساعد ذلك فريق المراجعة على فهم كيفية استخدام تطبيقك والإجراء الذي يقوم به كل زر.

Completed items

When an item is complete, the circle with a check mark will be filled in.

See Also

See the following documents to learn more about Meta App Review: