End User Authorization Flows
The Zoom App Marketplace lists all publicly available apps which can be installed by individual users or accounts (User-managed or Account-level apps). Zoom users can discover new apps through the Marketplace discovery page or search directly for specific apps.
App Administration and Permissions
User-level apps can be installed by any individual user on a Zoom account. These apps have specific access set for Zoom APIs to manage the individual user’s data, and thus authorization and deauthorization are managed by the user.
Account-level apps are installed only by Zoom Marketplace developer account admins and is used in order to manage users and the account usage. Installation of an Account-level app can be controlled by a Zoom account admin user with Marketplace role access. This role grants admins the ability to control which apps can be installed on the account and by individual users on the account. To set these permissions, navigate to Permissions in the My Admin Dashboard. This page allows admins to pre-approve the installation of apps, apply restrictions, or prevent users on an account from installing apps.
Pre-approval request flow for Users
For an app that has not already been installed and pre-approved by an admin, a user can request for the app’s pre-approval. To do so, navigate to the app in the Marketplace and click Request pre-approve on the app description page. If the request is approved by the admin and the user has all required Scopes for the app, a user can now install the app.
A sample pre-approval request flow for an end-user is shown below:
Pre-approval request processing for Admins
Admins can manage pre-approval requests made by users by navigating to App Requests in the My Admin Dashboard. Admins with Marketplace:Edit permissions can pre-approve or reject the requests. Admins can also view which users made requests through the Requests dropdown.
As an admin, you also have access to enable or turn off email notifications about app pre-approval requests. You can select up to five admins with Marketplace:Edit permission as recipients for the email notifications. Any of these admins can then accept or reject the pre-approval of the app. If you enable this option but do not add any recipients, the Zoom App Marketplace will automatically identify admins with the correct permissions and email them the notifications.
If you disable this option, you won’t recieve any email notifications but you can still view the pre-approval requests by navigating to MY ADMIN DASHBOARD > App Requests > Pre-approval Requests.
Disable Preapproved Apps
If an admin has pre-approved an app, it can be disabled by navigating to that app in the Marketplace and switching off the Pre-approve setting when needed.
Note: this will disable the app from all users in your account and should only be done if necessary.
Missing Permissions for App Installation
If a user is unable to install an app from the Marketplace, the user can view which missing permissions need to be granted before the app can be installed.
Some apps may only be installed for users by account admins. These apps will show a Request to Install button available for users to send app installation requests to admins.
Admins can view the app installation requests in the My Admin Dashboard and navigating to Request to Install. Here admins can either install the app or reject the request.
Uninstall an App
To uninstall an app on an account, navigate to the app by going to Manage > Installed Apps > and click Uninstall.
Clicking Uninstall will prompt a confirmation to remove the app. Users have the option to grant or deny permission for the app developer to retain their data. If consent is granted, the data will not be deleted. If permission is not granted, the developer is required to follow the Marketplace Data Compliance requirements and delete the data within 10 days of app removal.