App Review for Messenger API support for Instagram Apps

App Review is a process that allows you to request Advanced Access for any permissions and features that your app relies on.

Permissions with Standard Access can only be granted to your app by app users who have a direct role on the app itself, but permissions with Advanced Access can be granted to your app by anyone. Similarly, features with Standard Access are only active for app users who have a direct role on your app, but features with Advanced Access are active for everyone.

Before your app can be used by anyone other than people who have a direct role on the app itself, it must first undergo App Review.

Process Overview

The submission process requires you to explain how to test your app, and why your app needs each of the permissions and features you are including in your submission. In addition, you must include a screen recording that shows us how to test any functionality that relies on that permission or feature.

We will use your screen recording to test your app functionality and verify that it uses each requested permission or feature as depicted in your recording. If we are able to successfully test your app and verify that it uses each requested permission and feature correctly, all permissions and features in your request will be approved for Advanced Access and you can set them to Advanced Access in the App Dashboard.

If, however, we are unable to test the functionality that you have demonstrated in your screen recording, or the functionality doesn't work as depicted, you will not be approved for that permission or feature.

If we are unable to test your app at all, your entire submission will be rejected.

Before You Submit

  • Ensure your app abides by all applicable Facebook terms and policies, including Facebook’s Terms of Service, Platform Terms, Developer Policies, Community Standards, Instagram Terms of Use, and the Instagram Community Guidelines. See here an overview of some of the key Developer Policies applying to Messenger Platform and Messenger API support for Instagram (aka Instagram Messaging APIs).
  • Ensure your Facebook Page is connected to your Instagram Professional account.
  • Ensure your app can process webooks and media CDN URLs correctly.
  • Ensure your app can digest webhooks and use their contents to send and receive messages via the Send API and, if you have a custom inbox solution, get thread/message content via the Conversation API.
  • If your app is an automated experience, ensure it can escalate conversations to a human agent.
  • Ensure your app processes Story Mentions correctly.

Submitting Your App

To begin the submission process, load your app in the App Dashboard, navigate to the App Review > Requests panel, and click the Request Permissions or Features button.

When completing the submission process, use one of the guides below based on how your app will be used: