Instagram

Use this guide if your App Review submission was rejected for problems with any Instagram-related permissions or features you may have requested.

We are unable to verify the use case of the permission(s) requested while testing your app

During App Review, submission reviewers use a submission’s screen recording as a guide and will attempt to recreate how the app uses each of the permission(s) and/or feature(s) that your app is requesting. If a reviewer is unable to recreate the experience depicted in the screen recording, your app will unfortunately be rejected with "Unable to verify use case in app". If your submission is rejected for this reason:

  1. Make sure you have completed all development of your app.
  2. Create a Test User and verify that you can use it to recreate the experience exactly as depicted in your screen recording.
  3. If you are able to reproduce this experience exactly as depicted in your screen recording, verify that the testing instructions in your App Verification Details are correct and include the Test User’s email and password.
  4. If your screen recording is inaccurate but you are able to test each of your requested permissions and features with the Test User, capture a new, accurate screen recording and upload it, verify that the testing instructions in your App Verification Details are correct, and include your Test User's email and password.
  5. Resubmit for App Review.

Please also ensure that you also provide all test credentials required for the full Facebook Login authentication and the steps required to link your Instagram business account(s). If a reviewer is unable to test the Business Integration between the Instagram business account and Facebook Page, your app will be rejected as they were unable to verify the complete login experience.

Your use case is disallowed based on your submission details

During App Review, FB reviewers will evaluate the use case(s) and submission details you’ve presented to determine if they are valid and allowed. These use cases are described in our permissions and features references.

Instagram Basic

If you’re applying specifically for the instagram_basic permission, please note that the permission grants your app permission to read an Instagram Account profile’s information and media. Instagram Graph API also only allows Instagram Professional accounts - Businesses and Creators - to use your app to manage your presence on Instagram, and cannot access Instagram consumer accounts.

If you are building an app for consumer users, your app will be rejected with “Restricted use case”. If so, please consider Instagram Basic Display (IGBD) API instead.

Instagram Manage Comments

If you’re applying for the instagram_manage_comments permission, please note that mentions on Instagram Stories are not supported with this permission.

Instagram Manage Insights

If you’re applying specifically for the instagram_manage_insights permission, please note that you are not able to use the permission to retrieve Instagram ads data, nor attempt to build an ad network on Instagram. According to Facebook Platform Terms and Developer Policies, any data obtained through our API and permission(s) are not allowed to be transferred to an ad network directly or indirectly.

The instagram_manage_insights permission grants your app permission to access insights for the Instagram Business Account linked to the Facebook Page administered by the app user. These insights include the Instagram account’s metadata, data, and Instagram Story insights.

Instagram Public Content Access

If you’re applying for the Instagram Public Content Access (IPCA) feature, this feature allows apps to discover and read public Instagram photos and videos, on behalf of the Instagram business user. It grants your app an ability to search for Hashtags and pull data like media, comment count, like count etc. Do note that hashtags on Instagram Stories are not supported with this feature. Please ensure that your intended use case of the IPCA feature is clearly stated within your submission details. If your submission is rejected for the reason “Restricted use case”, please make sure that your app’s use of IPCA is allowed before resubmitting.

We were unable to verify the complete login experience

A submission reviewer will attempt to sign in to your submitted app and verify that it access data in an Instagram Business account in the manner that was described in the submission. If the reviewer is unable to sign into the app, or is unable to use the app to access data in an Instagram Professional account as described in the submission, the submission will be rejected with "We Were Unable to Verify The Complete Login Experience".

If your submission has been rejected for this reason:

  1. Make sure you have completed all developments of your app.
  2. Verify that your screen recording shows you signing into your app and authorizing it to access data in an Instagram Business account via the Facebook Login button. Recapture your screen recording if it doesn't show this.
  3. If your app users need to sign into your app with a non-Facebook account before using Facebook Login to authorize data access, include a non-Facebook test user’s credentials in your App Verification Details.
  4. Upload your new screen recording if you recaptured it.
  5. Resubmit for App Review.