# Zoom

> Source: https://truto.one/docs/integration-guides/zoom/

## Install Zoom integration

The Zoom integration can be found [here](https://app.truto.one/integrations/available/a59d8d7a-939a-4baa-b167-2977225cfeb1). Please install it in your environments before proceeding with the steps below.

## Registering your OAuth App
:::callout{type="warning"}
- `Administrator` role is required to use this API
:::

1. Log in to your Zoom Developer account.
2. Navigate to the App Marketplace > Develop > Build App.
   ![Click build app](https://docs-assets.truto.one/build-app-zoom.png)
3. Choose `OAuth` App.
   ![Add OAuth app](https://docs-assets.truto.one/create-oauth-zoom.png)
4. Fill in the required details for your app (name) as shown below.
   ![Add name for OAuth app](https://docs-assets.truto.one/name-oauth-zoom.png)
5. Click on `Create`.

## Add details to your OAuth App

1. Go to `Information` tab.
2. Add the descriptions.
3. Add company name, contact name and email.
4. You can add more details in information for the application.

## Add Scopes to your OAuth App

1. Go to `Scopes`.
2. Click on `Add Scopes` button.
3. Select the scopes as per requirement and Click on `Done`.
4. Add Descriptions for the scopes which will help them get verified for public use.

### Scopes required to get data in Truto

- To read [Users](https://truto.one/docs/api-reference/unified-user-directory-api/users) in Unified User Directory API  > `user:read:admin`
- To manage [Users](https://truto.one/docs/api-reference/unified-user-directory-api/users) in Unified User Directory API > `user:write:admin`
- To read [Roles](https://truto.one/docs/api-reference/unified-user-directory-api/roles) in Unified User Directory API > `role:read:admin`
- To read [Activities](https://truto.one/docs/api-reference/unified-user-directory-api/activities) and [Utilisation](https://truto.one/docs/api-reference/unified-user-directory-api/utilisation) in Unified User Directory API > `report:read:admin`
- To read [Billing](https://truto.one/docs/api-reference/unified-user-directory-api/billing) in Unified User Directory API > `report:master`

## Obtaining Access Credentials

1. In the `App Credentials` section, find your `Client ID` and `Client Secret` and Add them to Truto by overriding the [OAuth Credentials](https://truto.one/docs/guides/integrations/overriding-oauth-credentials).
2. Enter `Redirect URL for OAuth` as shown below.
   ![Add redirect url and copy client id and secret](https://docs-assets.truto.one/credentials-zoom.png)

- Redirect URL

```
https://api.truto.one/connect/zoom/callback
``` 

4. Add the same Redirect URL to `Add Allow List` under `OAuth Allow List`.
   ![Add redirect url to allow list](https://docs-assets.truto.one/allowlist-zoom.png)

## Publishing the OAuth App

1. Add details in `Technical Design`.
2. Go to `Submit`.
3. If details are missing. You will be able to check them here and you can add it.
4. After adding all the details, click on `Submit`.
5. After the OAuth App gets published, it will be available for all users.

## Connecting a Zoom account

1. Click on **Connect Account**
   ![Click connect account](https://docs-assets.truto.one/truto-connect-account.png)

2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on **Get connection link**
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)

3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too, and they will be able to connect their Zoom account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)

4. Select Zoom
   ![Select Zoom](https://docs-assets.truto.one/select-zoom.webp)

5. You'll now be asked to log in to your Zoom account and allow access to Truto. Go through the steps.

6. _Voila!_ You should now see a connection successful message. You can now close this tab.

7. Go to your Truto account, and you should see the new Zoom integration under **Integrated Accounts**. Click on the **Account ID** to view the details and initiate API calls.

## Making your first request 

Select the Zoom integrated account from the [Integrated Accounts](https://app.truto.one/integrated-accounts?search=zoom) tab. 
![Select the Zoom integrated account](https://docs-assets.truto.one/zoom-details-1.webp)

Click on the "Proxy API" tab 
![Navigate to Proxy API](https://docs-assets.truto.one/zoom-details-2.webp)

You can then try out any of the APIs that Truto currently supports for Zoom. 

![Try out the Users Proxy API which lists the users in your Zoom account](https://docs-assets.truto.one/zoom-details-3.webp)

![Just click Call API button to make the network call. You can also call the Proxy API programatically](https://docs-assets.truto.one/zoom-details-4.webp)

## Uninstalling the Zoom integration 
To uninstall the Zoom integration from your Truto account, select the Zoom integration from the [Integrations](https://app.truto.one/integrations/installed?search=zoom) tab.
![Select the Zoom integration](https://docs-assets.truto.one/zoom-details-5.webp)

Click on the Settings tab 
![Click on Settings tab](https://docs-assets.truto.one/zoom-details-6.webp)

And then click on Uninstall. Uninstalling the integration will also remove all the Zoom integrated accounts from your Truto account.
![Click Uninstall to remove the Zoom integration](https://docs-assets.truto.one/zoom-details-7.webp)

On uninstallation, the access tokens generated for any connected Zoom accounts will be revoked.

## Support 

If you face any issues using the Zoom integration provided by Truto, please mail to support@truto.one 

## Working hours

Monday - Friday, 2:30AM - 4:30PM EDT

## First Response SLA

24 - 48 hours