Zoom

How to configure a Zoom connection

This document describes the Dataworkz connector configuration required to access Zoom. This document walks through the authentication process to create a private connected app for Zoom REST API access.

Prerequisite

You need a Zoom Admin account for configuring a Zoom connector in Dataworkz. Follow the steps below for creating a private connected App (skip to the next section if already done).

1. Login to Zoom Marketplace (https://marketplace.zoom.us/) with credentials that have an Admin role

2. Process of creating a private connected app for OAuth is described here - https://developers.zoom.us/docs/integrations/create/ . During the process keep the following in mind.

   • select Account-level app

   • make a note of the Client ID & Client Secret as the same would be required while configuring Dataworkz connector

   • Redirect URL can be found using the process described under Private Connected App

   • add Dataworkz application URL to the allow list

   • Add the following to the list of Scopes

     • dashboard_meetings:read:admin

     • meeting:read:admin

     • recording:read:admin

     • report:read:admin

     • user:read:admin

Create Connector for Zoom

1. Login to Dataworkz Application

2. Goto Configuration -> SaaS Applications -> Zoom

3. Click the + icon to add a new configuration

   
4. Enter name for the configuration in the above screen

5. Select the authentication type

   • Private Connected App (OAuth for users of the account)

   • API key (deprecated now)

Private Connected App

1. If the OAuth connected app is already created select Yes else select No.

   • Selecting No would pop up a window with a redirect URL

   • Make note of this redirect URL and create a private connected app as described in Prerequisite section

   
2. Enter the Client ID & Secret that was saved during the App creation

3. Select the workspace & collection

4. Click Save. This would prompt you to login to Zoom account and authorize Dataworkz to access Zoom APIs

Newly created connector would show up in the list of Zoom configurations

Add Configuration

Click the newly created connector and then click + icon to add configuration for Zoom

1. Enter name for the dataset

2. Select the zoom account report type

3. Select either a date range or “all historical records”

4. Enable/disable recurring job

5. Click Add

This would complete the Dataworkz configuration for Zoom