# Zoom authentication

> Depending on the authentication type you select, you need one of
the following credentials:

## Prerequisites

Depending on the authentication type you select, you need one of
the following credentials:

* OAuth 2.0 Authorization code: the email address and password associated with your account.
* Bring your own OAuth 2.0 app: client ID and client secret.

For creating a private OAuth2 app, follow the steps mentioned in the Zoom [documentation](https://developers.zoom.us/docs/integrations/create/).

:::note
When registering your OAuth application in Zoom, make sure to set the [callback URL](connections#callback-url) to the value displayed on the connection creation page, for example `https://cloud.uipath.com/provisioning_/callback` for Automation Cloud.
:::

To be able to create a standard connection, you need to have a valid Zoom account.

* An administrator must set valid permissions for Zoom app pre-approval.
  + Sign in to [the Zoom marketplace](https://marketplace.zoom.us/) .
  + Search for an app and select on the icon to select it.
  + In the **Who can install** section, enable the **Pre-approve** toggle.By default, **Allow all users on your account to install this app** is selected. If you would like to instead pre-approve the app for certain users or groups:
  + Select **Allow specific users or user groups to install this app**.
  + Select **Add users**.
  + Add users with the following options:
  + **Add an individual user**: Enter the email address of the user in your account and select **Add**. Repeat this process as necessary to include additional users.
  + **Add a user group**: Enter the group name of the user group in your account and select **Add**. Repeat this process as necessary to include additional user groups.

:::note
A combination of individual users and user groups can be given access to a pre-approved app. When a Zoom App is pre-approved
for users and/or groups of users, they are notified of the pre-approval to use that Zoom App.
:::
:::note
Please note that Zoom currently does not support multi session support for OAuth 2.0 connections. This is currently being
tracked as a high priority request with the following reference: ZOOM-325298. More information can be found in the Zoom [developer knowledge base](https://devforum.zoom.us/t/frequent-invalid-token-requests/51376).
:::

## Add the Zoom connection

To create a connection to your Zoom instance, you need to perform the following steps:

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the **Connections** tab.
3. Select **Add connection**.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. You can choose between two authentication types: OAuth 2.0 Authorization code or Bring your own OAuth 2.0 app.
6. Enter the required credentials for your preferred authentication method and select **Connect**.

   For any secret-type field, you can select the menu next to the field and choose **Use credential asset** to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see [Use credential assets for connections](credential-store-connections.md).

If you encounter an error stating that the application needs pre-approval, have your Zoom administrator follow these steps:

1. Sign in to [https://marketplace.zoom.us](https://marketplace.zoom.us/) as an account owner or admin.
2. In the top-right corner of the Marketplace, select **Manage**.
3. In the **My Admin Dashboard** section, select [**Permissions**](https://marketplace.zoom.us/user/permissions).
4. Select the **Require publicly listed apps on the Zoom App Marketplace to be pre-approved for your users** toggle to enable or disable it.
5. If a verification dialog displays, select **Turn On** to verify the change.
6. (Optional) Select the **Allow publicly listed apps created by Zoom to be installed without admin pre-approval** check box to exempt Zoom-created apps from pre-approval by an admin.
7. (Optional) Select the **Allow publicly listed apps created by users in your account to be installed without admin pre-approval** check box to exempt apps created by a member of your organization from pre-approval by an admin.

:::note
If pre-approval of Zoom Apps is disabled, users on your account will be notified of the updated permissions to use Zoom Apps.
This notification requires version **5.9.6** or higher. If pre-approval of Zoom Apps is enabled, an email notification will be sent out to **all the users** in your account. You can read more on this [here](https://support.zoom.us/hc/en-us/articles/4413265586189).
:::

## Privileges and permissions

* When creating a connection via Zoom, you must allow the application to view and manage information in accordance with the
  following privileges and permissions:
  + meeting:write
    - This scope allows an app to view and manage user's meetings. This includes performing actions such as scheduling and updating
      meetings, g meetings, and updating live streaming options.
  + recording:read
    - This scope allows an app to view a user's meeting or webinar recordings.
  + user\\_info:read
    - This scope allows an app to view your own user information. This scope is a subset of the `user:read` scope. Because of this, you do not need to request both this scope and the `user:read` scope.
* More information regarding the OAuth 2.0 scopes can be found via the Zoom [vendor documentation](https://developers.zoom.us/docs/integrations/oauth-scopes/).

  
![docs image](https://dev-assets.cms.uipath.com/assets/images/integration-service/integration-service-docs-image-277545-def86aa8.webp)