# How to Obtain APIs

To obtain API credentials, visit the **Zoom App Marketplace** at [https://marketplace.zoom.us/](https://marketplace.zoom.us/) and sign in with your Zoom account. If you don't have a Zoom account, you can create one using this [link](https://zoom.us/signup).

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FPSTXaskR0Mg2hVPgKkb9%2Fimage.png?alt=media&#x26;token=30c72049-5aa8-4010-b1dd-bebdbfcbce99" alt=""><figcaption></figcaption></figure>

eRoom requires  Server-to-Server OAuth and Meeting SDK APIs to connect with Zoom and use its functionalities.

{% hint style="info" %}
To make the Zoom Credentials work, the SSL should be activated on your domain.
{% endhint %}

## Server-to-Server App Credentials <a href="#server-to-server-oauth-credentials" id="server-to-server-oauth-credentials"></a>

1. On the **Zoom App Marketplace** page, click **Develop** and select **Build App** from the dropdown menu.

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FzWgPuP2wbuU0aGZ7xJCq%2Fimage.png?alt=media&#x26;token=51a8882e-0bf9-4a99-9718-0d33a6c6f3cb" alt=""><figcaption></figcaption></figure>

2. In the popup window, choose **Server-to-Server OAuth App** and click on the **Create** butto&#x6E;**:**

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FYRFoRkkdT9SWRkObCDNo%2Fimage.png?alt=media&#x26;token=fc000c5f-f864-4027-8456-5c11d8bffe09" alt=""><figcaption></figcaption></figure>

3. Give a name to your App and click on **Create**:

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2Fbl1uN0di56m54TtbD3T0%2Fimage.png?alt=media&#x26;token=9b46f065-666b-402e-8f0d-261cfa5a224e" alt=""><figcaption></figcaption></figure>

4. After completing this step, the system will automatically create API credentials, available in the **App Credentials** section.

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FOOyHK59loVOCZ5s8q1et%2Feroomzoom%203.jpg?alt=media&#x26;token=6b85d3ea-5b98-4880-b5f8-4b975a93a0c8" alt=""><figcaption></figcaption></figure>

5. After selecting **Continue**, you will be taken to the **Information** page. On this page, you are required to enter essential details for your app, including your email and a description. Please ensure you accurately complete the following fields in the **Information** section:

* **Company Name**
* **Developer Contact Name**
* **Developer Contact Email**

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2Fa3228XF919QjgUNLGDv9%2Feroomzoom%204.jpg?alt=media&#x26;token=0712afa0-a871-41cb-adda-7eb14f45bb26" alt=""><figcaption></figcaption></figure>

6. You can skip the next step **Feature.**

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FMAvFkea1oOwESxiorEAP%2Feroomzoom%205.jpg?alt=media&#x26;token=524611b0-079d-4651-b26a-73bcf46b7c17" alt=""><figcaption></figcaption></figure>

7. Next, to ensure the plugin functions correctly, navigate to the Scopes tab and select **Add Scopes**.

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FJwLg9cpZv2Ipzb9cpiEk%2Feroomzoom%206.jpg?alt=media&#x26;token=41dbbc7b-ccf5-4efb-98c1-aa5643e84481" alt=""><figcaption></figcaption></figure>

### Required Scopes

{% hint style="warning" %}
Permission issue error notices may appear while creating the meetings or webinars when any of the listed Scopes are not enabled.
{% endhint %}

You can use **the searchbar** of the scopes menu to fasten the process:

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2Fa30tW403WnRyyBrJZ73y%2Fimage.png?alt=media&#x26;token=0582ba2c-8db2-4307-bebd-b9d733f68b70" alt=""><figcaption></figcaption></figure>

Below you can see all required scopes:

**Account**

* View account info
  * View an account's settings (account:read:account\_setting:admin)
  * View an account's settings (account:read:account\_setting:master)
  * View an account's settings (account:read:settings:admin)
* View and manage account info&#x20;
  * Update an account's settings (account:update:settings:admin)
* View and manage sub accounts
  * Update an account's options (account:update:options:admin)
  * Update an account's owner (account:update:owner:master)
  * Update an account's settings (account:update:settings:master)

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FXzTMd7NIez6TUp1z9k3S%2Fimage.png?alt=media&#x26;token=79f859b1-f58d-4ebb-abbe-2f7209f3f320" alt=""><figcaption></figcaption></figure>

**Meeting**

* View all user meeting summaries&#x20;
  * View a meeting's summary (meeting:read:summary:admin)
* View all user meetings
  * View a meeting's chat message (meeting:read:chat\_message:admin)
  * View a meeting's invitation (meeting:read:invitation:admin)
  * View a user's meetings (meeting:read:list\_meetings:admin)
  * View a user's upcoming meetings (meeting:read:list\_upcoming\_meetings:admin)
  * View a meeting (meeting:read:meeting:admin)
* View and manage all user meetings&#x20;
  * Delete a meeting (meeting:delete:meeting:admin)
  * Update a meeting (meeting:update:meeting:admin)
  * Update a meeting's status (meeting:update:status:admin)
  * Create invite links for a meeting (meeting:write:invite\_links:admin)
  * Create a meeting for a user (meeting:write:meeting:admin)
* View live streaming meeting token information&#x20;
  * View a meeting live streaming join token (meeting:read:live\_streaming\_token:admin)&#x20;
* View local archiving meeting token information&#x20;
  * View a meeting local archiving join token (meeting:read:local\_archiving\_token:admin)

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FdleP6cbB5OFt2tKSUqFP%2Feroomzoom%208.jpg?alt=media&#x26;token=324feabe-be69-4dcf-8a51-129a51fa11ab" alt=""><figcaption></figcaption></figure>

**User**

* View all user information&#x20;
  * Verify a user's email (user:read:email:admin)
  * View a user's assistants (user:read:list\_assistants:admin)
  * View a user's permissions (user:read:list\_permissions:admin)
  * View users (user:read:list\_users:admin)
  * View a user's settings (user:read:settings:admin)
  * View a user's token (user:read:token:admin)&#x20;
  * View a user (user:read:user:admin)&#x20;
* View user's zak token
  * View a user's Zoom Access Key (user:read:zak:admin)
* View users information and manage users
  * Delete a user (user:delete:user:admin)
  * Update a user (user:update:user:admin)
  * Create a user (user:write:user:admin)

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FTZSoKJLAJWqo38BHs1Pe%2Feroomzoom%209.jpg?alt=media&#x26;token=ff24a242-dcf4-4f52-859f-3ee48ff4d071" alt=""><figcaption></figcaption></figure>

**Zoom Events**

* Manage event speaker information&#x20;
  * Remove an event's speaker (zoom\_events:delete:speaker:admin)&#x20;
  * Update an event's speaker (zoom\_events:update:speaker:admin)&#x20;
  * Add a speaker to an event (zoom\_events:write:speaker:admin)&#x20;
* View all events information&#x20;
  * View an event (zoom\_events:read:event:admin)
  * View events (zoom\_events:read:list\_events:admin)
* View event's Access Link&#x20;
  * View zoom event access links (zoom\_events:read:list\_access\_links:admin)

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FQ0WmuUBZdFrDMGXwU7Ef%2Feroomzoom%2010.jpg?alt=media&#x26;token=a697464d-891d-47b6-bb03-ace0777c3d29" alt=""><figcaption></figcaption></figure>

**Webinar**

* View all user Webinars
  * View a webinar's participant (webinar:read:participant:admin)
  * View a webinar (webinar:read:webinar:admin)
  * webinar:read:list\_webinars:admin
* View and manage all user Webinars
  * Delete a webinar (webinar:delete:webinar:admin)
  * Update a webinar's status (webinar:update:status:admin)&#x20;
  * Update a webinar (webinar:update:webinar:admin)
  * Create invite links for webinars (webinar:write:invite\_links:admin)
  * Create a webinar for user (webinar:write:webinar:admin)
* View and manage sub account's user webinars
  * Delete a webinar (webinar:delete:webinar:master)
  * View a webinar (webinar:read:webinar:master)
  * Update a webinar (webinar:update:webinar:master)
  * Create invite links for a webinars (webinar:write:invite\_links:master)
  * Create a webinar for a user (webinar:write:webinar:master)
  * webinar:read:list\_webinars:master

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FstMMeEI7lasmZ6UHeOPl%2Feroomzoom%2011.jpg?alt=media&#x26;token=8309d8ee-25b6-4fb7-aeb4-fcdc7852e76c" alt=""><figcaption></figcaption></figure>

Once you've added all the necessary Scopes, click on the **Done** button.

{% hint style="info" %}
To learn more about scopes and expand the functionality of the app, read [Zoom's doc about OATH Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/).
{% endhint %}

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2F6WYIHQ4gZJerX7hhha1E%2Feroomzoom%2012.jpg?alt=media&#x26;token=d1c2cf9a-fd27-428d-b874-31e7c0558e52" alt=""><figcaption></figcaption></figure>

Click **Continue** to go to the final step.

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FaJzL1DBdfe9q1Uokbcy5%2Feroomzoom%2013.jpg?alt=media&#x26;token=858432eb-a4ab-493c-a657-e08e06d5c093" alt=""><figcaption></figcaption></figure>

8. Finally, activate the Server-to-Server App:

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FseKFpifBva51J5Rv3kbH%2Feroomzoom%2014.jpg?alt=media&#x26;token=16dd5bf1-de3b-4f4b-8f3e-ec628e52863a" alt=""><figcaption></figcaption></figure>

9. Copy the **Account ID, Client ID,** and **Client Secret** and paste them into the respective fields on the **Zoom Settings** page in your dashboard and save the settings:

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FznBcZ9GmJSJE45fU9qLE%2FeRoom%20-%20Server2server%20zoom%20settings.png?alt=media&#x26;token=3ec6483d-d6b0-4adb-9d4f-7e0d0f519d8c" alt=""><figcaption></figcaption></figure>

## Meeting SDK Credentials

{% hint style="success" %}
Zoom Meeting SDK offers video-conferencing features that mirror the meeting experience in the Zoom Client. Meeting SDK is required to make **Join In Browser** work.
{% endhint %}

1. Go to the **Zoom App Marketplace** at [https://marketplace.zoom.us/](https://marketplace.zoom.us/).

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FiJ4Rptx7gQVVh8yfUCJY%2Fimage.png?alt=media&#x26;token=6b22c146-1401-4538-8960-b61c628c0b2b" alt=""><figcaption></figcaption></figure>

2. On the **Zoom App Marketplace** page, click **Develop** and select **Build App** from the dropdown menu

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FTJRLhuhgGQl5E4aIokzN%2Fimage.png?alt=media&#x26;token=967a4265-9807-4786-9551-adbae16b8643" alt=""><figcaption></figcaption></figure>

3. In the popup window, choose **General App**:

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FOlrVBjlmDV16r2UaBkwN%2Fimage.png?alt=media&#x26;token=d7642dc5-6953-4b20-afbe-ad9b845696d6" alt=""><figcaption></figcaption></figure>

4. On the opened page, name the App according to your needs:

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FdRKKQINTX0DCZn1YyMdw%2Fimage.png?alt=media&#x26;token=cf4683e2-918b-4b86-a39f-6b03da82cba0" alt=""><figcaption></figcaption></figure>

5. In the B**asic Information** page choose **Admin-managed** as the app management type and **Save** it:

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FrcCjNCK2QZNHFI4YlERw%2Fimage.png?alt=media&#x26;token=12f0bdab-7199-492d-8be7-3601fc95cbd0" alt=""><figcaption></figcaption></figure>

6. Indicate your site URL (including https part) to **OAuth Redirect URL** field on the same - Basic Information page (e.g: <mark style="color:green;">https://yourwebsite.com</mark>):

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FiMj4IxdmVO03011QJVwv%2Fimage.png?alt=media&#x26;token=40332185-206b-4b11-93b0-22c7d3afa29c" alt=""><figcaption></figcaption></figure>

7. Jump to the **Embed** tab and enable **Meeting SDK**:

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FaDgdoPmjLyNpOLKQhaCa%2Fimage.png?alt=media&#x26;token=77e396c5-58ce-4e41-8223-193801a6c64b" alt=""><figcaption></figcaption></figure>

8. Move to the **Scopes** page and click on **Add Scopes:**

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FG1YxnGyrp4EQ4QkhepHY%2Fimage.png?alt=media&#x26;token=ba16967e-fb1f-47b6-bb33-d0cf1e9f49ae" alt=""><figcaption></figcaption></figure>

9. Add the following scope and click on **Done**:

* **User > View user's zak token** (`user:read:zak:admin`)

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2Fa0WPwOULfZu9Foy4YyQY%2Fimage.png?alt=media&#x26;token=f875894d-ad92-45dd-a498-ca4008b8bf63" alt=""><figcaption></figcaption></figure>

10. Copy the **App Credentials** and paste them to the designated area in eRoom settings and **save the changes:**

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FZVMlQUGI17QgfFKDMZ1u%2Fimage.png?alt=media&#x26;token=fabb49eb-db54-4f06-956d-f85aa9181aa0" alt=""><figcaption><p>Credentials</p></figcaption></figure>

<figure><img src="https://881466253-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTNthMMT8aFVfZDeA2%2Fuploads%2FjxvwFELlTz4tKCSuYYIB%2Fimage.png?alt=media&#x26;token=542576a5-34b9-4176-a9aa-c8df0595e396" alt=""><figcaption></figcaption></figure>

Good job, you have done it succesfully!
