Release

Once you have completed app development and testing, you can release your app. Releasing means to make your app available to users who do not have a role on the app itself. This document lists the processes and app settings that may be required before you can release your app successfully.

If your app will only be used by people who have a role on the app itself you do not need to complete any of these processes because your app is already available to these users.

If you have already released your app and want to release new functionality that requires App Review, follow the steps in our App Review For Live Apps instructions.

App Review

If your app will be used by anyone who does not have a role on it, it must undergo App Review.

App Review is a process that allows you to request approval for specific API permissions and features that your app needs to function properly. Only permissions approved through the App Review process can be granted to your app by app users without a role on the app, and only approved features will be active for those users.

App Review requires you to identify each of the permissions and features your app needs, describe why your app needs them, and show us how your app uses the data returned or accepted by our APIs.

Learn more about the App Review process.

Business Verification

Business Verification is a process that allows us to verify your identity as a business entity. Apps that request advanced access for permissions and apps that allow other Businesses to access their own data must be connected to a Business that has completed Business Verification. Until then, app users from other Businesses will be unable to grant these apps permissions and all features will be inactive.

Learn more about Business Verification.

Individual Verification

As of February 1, 2023 Individual Verification may no longer be available.

If your app requires advanced level access to permissions, you might need to complete Business Verification. See this blog post for more information.

Individual Verification is a process that allows us to gather information about you so we can verify your identity as a person as opposed to a business entity or organization. If you are not a business entity or organization but your app allows other Businesses to access their own data, you may be required to complete Individual Verification before it can be used by people in those Businesses.

Learn more about Individual Verification.

Live Mode

You must switch your app to Live mode before it can request App Review approved permissions from app users who do not have a role on it, and before approved features will be active for those users. However, you should not switch to Live mode until all of the permissions and features that your app requires have been approved, and not before you have completed Business Verification or Individual Verification, if required to do so. If you switch your app to Live mode prematurely, your app will be unable to request unapproved permission from app users, and any unapproved permissions will be inactive.

Consumer apps behave a little differently because they also rely on access levels. Consumer apps in Live mode cannot request permissions with Standard Access from app users who do not have a role on them, and features with Standard Access will be inactive for these users.

Business apps do not have app modes and rely exclusively on access levels.

Releasing New Versions of Live Apps

If your app is already in Live mode and you want to release new functionality that requires App Review, follow the steps in our App Review For Live Apps instructions.

Limited Release Using Geo-Restriction

If you want to release your app to a small set of users before making it available to everyone, you can configure app restrictions that only make your app available to users in certain age groups and geographic locations.

Learn more about app restrictions.