# Zoom Integration Setup

### Getting Started <a href="#h_01h9ktyhn71tjz55xjpb55rz13" id="h_01h9ktyhn71tjz55xjpb55rz13"></a>

BalkanID recommends creating a separate service account for the purposes of this integration, instead of using personal or employee named accounts.&#x20;

#### Requirements: <a href="#h_01hq31mqhk4ydxp5ct5cd14ex3" id="h_01hq31mqhk4ydxp5ct5cd14ex3"></a>

* ***Client ID***
* ***Client Secret***
* ***Tenant ID(Account ID)***

#### Getting the Configuration <a href="#h_01h9ktyhn7bn6qk4fpgcgjzp5v" id="h_01h9ktyhn7bn6qk4fpgcgjzp5v"></a>

1\. On the Zoom Admin console, navigate to the users section <https://us06web.zoom.us/account/user#/> and click **Add user**.<br>

<figure><img src="https://content.gitbook.com/content/bVGYwk8aSk5yI1GDPEW9/blobs/qYusBWMJFjtGI7MzsWHL/image.png" alt=""><figcaption></figcaption></figure>

2\. Activate the user:

* Users → View
* Role Management → View
* Groups → View
* Zoom for developers → Server-to-Server OAuth app → Edit

  Create a role from the roles dashboard <https://us06web.zoom.us/role#/> and grant it the following permissions:<br>

  <figure><img src="https://content.gitbook.com/content/bVGYwk8aSk5yI1GDPEW9/blobs/1VY5IiB5k5HnqWXAqSis/image.png" alt=""><figcaption></figcaption></figure>

3\. Add the user you created to the role that you set up.

4\. Login as the user.

5\. Head over to the apps page <https://marketplace.zoom.us/develop/create> and create a “Server-To-Server OAuth” application.

6\. Enter your details and setup your API scopes as mentioned below:

<figure><img src="https://content.gitbook.com/content/bVGYwk8aSk5yI1GDPEW9/blobs/2dTjrqw2XxbYhWmhEhO2/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/bVGYwk8aSk5yI1GDPEW9/blobs/o5aFKvUCuUx07jJq2nIR/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/bVGYwk8aSk5yI1GDPEW9/blobs/R6zQcL95Y9VOELp7wY3Y/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/bVGYwk8aSk5yI1GDPEW9/blobs/e1ntdeMtn6IHqx6hjhpN/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/bVGYwk8aSk5yI1GDPEW9/blobs/vNLM80UCyb9xlJn20mio/image.png" alt=""><figcaption></figcaption></figure>

#### Authorization <a href="#h_01h9ktyhn7v07wfvm98nx4g9tb" id="h_01h9ktyhn7v07wfvm98nx4g9tb"></a>

* The client will be required to create a user with the aforementioned permissions granted by a role.
* The Server-To-Server OAuth app needs the following scopes:
  * group
    * group:read:admin
  * user
    * user:read:admin
  * role
    * role:read:admin

### Configure Zoom within your BalkanID tenant <a href="#h_01h9ktyhn77ksnhtt3q91dk2jb" id="h_01h9ktyhn77ksnhtt3q91dk2jb"></a>

1. Login to the BalkanID application and switch to the tenant you would like to add your integration to.
2. Head to *Integrations* > *Third Party Applications* and click **Add Integration**, select **Zoom**. Set up the *Primary Application owner* and the *Description*, if any.<br>

   <figure><img src="https://content.gitbook.com/content/bVGYwk8aSk5yI1GDPEW9/blobs/X1pblPaxVUnj0rmvExy4/image.png" alt=""><figcaption></figcaption></figure>
3. *Zoom* would have been added to the list of applications. Click on the **Configure and Integrate** button beside the integration name, and configure the fields with the values that were noted prior. It should look like this:<br>

   <figure><img src="https://content.gitbook.com/content/bVGYwk8aSk5yI1GDPEW9/blobs/EvhirJzj9yNtPyq6i40A/image.png" alt=""><figcaption></figcaption></figure>
4. Once you filled in the information, click **Save changes**. Your integration is now configured and you will see the status of the integration displayed alongside other integrations on the *Integrations* page. Integrations are synced daily. When data is available, the integration Status column will read **Connected** and the integration Message will read **Data available**.