Submitting Your Messenger App

When you are ready to release your app to the public, you must submit it for review. This review process allows us to ensure your Messenger app abides by our policies and functions as expected before it is made available to everyone on Messenger.

To submit your app, review the requirements and follow the steps below.


Before you submit your app, please do the following:

  • Ensure your app abides by all of the Messenger Platform and Facebook policies.
  • Ensure your app follows the Facebook Community Standards.
  • Review our pre-launch checklist.
  • Publish the Facebook Page associated with your app.
  • Ensure your webhook is functioning as expected and returning a 200 OK response to webhook events within 20 seconds.
  • If your app has gated functionality or content, provide a way for our review team to access and test it. For example, if a feature requires a user to log in to your service, be sure to provide a username and password in the submission notes. Another common practice is to provide a trigger phrase our reviewers can send to your app that will allow them to start normally gated flows.
Configure Your App Settings

At a minimum, you must provide the following basic information in the app console under Settings > Basic:

  • App Icon
  • Privacy Policy URL
  • Category
  • Business Use

Allow Users to Message Your Page
To receive messages from users, you must enable messaging for your Page. To do this, do the following:
  1. Go to Page Settings > General.
  2. In the 'Messages' section, click the 'Edit' button.
  3. Select the 'Allow people to contact my Page privately by showing the Message button' checkbox.
  4. Click 'Save Changes'

Put Your app in Development Mode
Now that you are ready to submit, ensure your app is set to development mode in your app settings.
Select app permissions

In the 'App Review for Messenger' section of the Messenger settings for your app, click the 'Add to Submission' button for each permission your app requires. Added permissions will appear in the 'Current Submission' section below.

Add Submission Details
In the 'Current Submission' section, click the 'Add Details' button for each requested permission. For each permission, a dialog will be displayed with a form for supplying additional information. Make sure to carefully complete the form in detailed for a successful review.
Submit your app

Click the 'Submit for Review' button to submit your app. The name of the person who submitted the app and the time it was submitted will be displayed.

After your app is submitted, the review team will send messages to your app to test for responsiveness, functionality, and policy compliance. The review team may message/use your app several times over the course of multiple days.

Provide Verification Information and Documents

Once your app has been reviewed for responsiveness, functionality, and policy compliance, you will receive a message asking you to complete business verification or individual verification in the 'Alerts' tab of the app console.

Business Verification

To begin business verification, click the 'Start Business Verification' button in the message. You will be asked to provide the following for the business that owns the app:

1. Basic business information, including business name, address, and phone number.

2. A copy of one of the following documents that prove your business is real:

  • Business license (preferred)
  • Certificate of formation
  • Articles of incorporation document
  • Business utility or phone bill

In addition, the document must show your company's legal business name, as well as one of the following:

  • Address
  • Tax ID
  • Phone number

Business verification is required once per Business Manager account. Once business verification is complete, any additional apps submitted that are owned by the same Business Manager account will not be asked to complete business verification.

3. The name, job title, and email address of a signatory for the business.

Individual Verification

Individual verification is a process that allows us to verify your identity so you can gain limited access to functionality normally reserved for businesses. If you are a non-business developer such as a student or hobbyist, and your app only needs limited access to the Messenger Platform, you can complete individual verification instead of business verification.

Please note that apps that use individual verification may subscribe to receive webhook events for a maximum of 3 Pages.

To complete individual verification, will be asked to provide:

  • Your legal name
  • Your email address
  • A phone number where we can reach you, if necessary
  • An image copy of a valid government issued ID (passport, driver's license, ID card, etc.)
Accept Supplemental Terms and Sign Tech Provider Agreement

After your business information and verification documents are submitted, you will receive an email from the Facebook legal team with links to the following:

  • Supplemental terms: These are additional terms that all app developers must accept to use extended Facebook Platform products, including the Messenger Platform.

    The supplemental terms will be sent to you in an email with the subject line, "[Action Required] Supplemental Terms for Extended Platform Products with Facebook".

  • Tech Provider Agreement: An additional contract that must be signed by a signatory of the business. This is only required for apps whose 'business use' in their app settings is set to 'Provide services to other businesses'.

    The Tech Provider Agreement will be sent to you in an email with the subject line, "Please sign Technology Provider Amendment"

You must read and accept the supplemental terms, as well as read and sign the Tech Provider Agreement (if applicable) as part of the business verification process.

If you do not receive the supplemental terms and, if applicable, the Tech Provider Agreement, please check your spam folder.

Watch for Approval Alerts

Once both business verification and app review has finished you will get a notification.

When approved, a green checkmark will also appear next to the pages_messaging permission under 'App Review for Messenger'.

What to do if your app is not approved

click the 'Add to Submission' button next to 'pages_messaging' to see the feedback from our review team.

If you have any questions, you can communicate directly with the review team to clarify how you can update your app by using the 'Ask a Question' button below the rejection notice.