# Zoom

![Image 1 of 1](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182800490637.png)
Zoom is a cloud-based video and audio conferencing platform. It allows you to set up virtual video and audio conferencing, one-to-one chat sessions, webinars, live chats, screen-sharing, and other collaborative capabilities.

Zoom can be connected with Relyance AI using either:

- [Server-to-Server OAuth (Recommended)](#h_01JX2CTN0Z4T9V13JCA2YD48RH)
- [OAuth2 / App Token](#h_01JXASMZKNNFPG65N8W6VTBFZV)

### Which method to choose

Both are listed above; the difference that matters later is what holds the
authorisation:

| Method | Authorises as | Needs re-authorising? |
| --- | --- | --- |
| **Server-to-Server App** (recommended) | the app itself, using Account ID + Client ID/Secret | No |
| OAuth2 / App Token | the user who completed the browser flow | Yes, when their grant is revoked or expires |

A Server-to-Server app also keeps the connection independent of any one person's
Zoom account remaining active, which is the usual reason a working Zoom
connection stops.

### **Creating Server-to Server App in Zoom**

1. Login to your Zoom account.
2. On the side menu expand the **Admin** section and click **Advanced** and then **App MarketPlace**.
3. In the top right corner click on the **Develop** dropdown and select **Build App**.
**Note**: If you've already created an app then click on the **Manage** link *beside* the drop-down.
4. Choose **Server-to-Server OAuth App** in the resulting dialog and click **Create**.
5. Provide a meaningful name as the App Name (e.g. Relyance Scan).
6. Copy the **Account ID**, **Client ID** and **Client Secret** to be used in Relyance.
7. In the OAuth Information section, fill in the fields - **Short Description, Company Name, Developer Contact information** (these fields are mandatory to activate the app) ,and click **Continue**
8. Click **Scopes** from the left-hand navigation menu.
9. Click on the **Add Scopes** button.
10. The list of scopes that should be added is here: **Contact Center**
contact_center_inbox:read:admin
contact_center_queue:read:admin
contact_center_recording:read:admin
contact_center_region:read:admin
contact_center_skill:read:admin
contact_center_user:read:admin
contact_center:delete:queue_supervisor:admin
contact_center:read:inbox_user:admin
contact_center:read:list_address_book_contacts:admin
contact_center:read:list_address_books:admin
contact_center:read:list_engagements:admin
contact_center:read:list_inboxes:admin
contact_center:read:list_queue_agents:admin
contact_center:read:list_queues:admin
contact_center:read:list_recordings:admin
contact_center:read:list_region_users:admin
contact_center:read:list_regions:admin
contact_center:read:list_skill_users:admin
contact_center:read:list_skills:admin
contact_center:read:list_users:admin
contact_group:read:list_groups:admin
contact_group:read:list_members:admin

![Screenshot](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182800494733.png)

![Screenshot](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182813216909.png)

![Screenshot](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182800505613.png)
![Zoom-1.png](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182813211021.png)

![Zoom-10.png](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182800494093.png)
**Contact Group**
contact_group:read:list_groups:admin
contact_group:read:list_members:admin

**Dashboard**
dashboard:read:chat:admin
dashboard:read:list_meeting_participants_qos:admin
dashboard:read:list_meeting_participants:admin
dashboard:read:list_meetings:admin
dashboard:read:list_webinar_participants_qos:admin
dashboard:read:list_webinars:admin
dashboard:read:meeting_sharing:admin
dashboard:read:meeting:admin
dashboard:read:zoomroom:admin

**Device**
device:read:list_groups:admin
device:read:list_zdm_devices:admin **Mail**
email:read:list_setting_filters
email:read:profile:admin
email:read:setting_filter:admin

**Groups**
group:read:list_groups:admin

**Marketplace**
marketplace:read:app_request:admin
marketplace:read:app:admin
marketplace:read:list_apps:admin

**Meetings**
meeting:read:list_meetings:admin
meeting:read:list_past_instances:admin
meeting:read:list_past_participants:admin
meeting:read:list_poll_results:admin
meeting:read:list_registrants:admin
meeting:read:list_summaries:admin
meeting:read:meeting:admin
meeting:read:past_meeting:admin
meeting:read:summary:admin

**Phone**
phone:read:call_log:admin
phone:read:list_call_logs:admin
phone:read:list_call_pickup_groups:admin
phone:read:list_call_recordings:admin
phone:read:list_external_contacts:admin
phone:read:list_numbers:admin
phone:read:list_recordings:admin
phone:read:list_shared_line_appearances:admin
phone:read:list_tracked_locations:admin
phone:read:list_users:admin
phone:read:list_voicemails:admin
phone:read:role_member:admin
phone:read:sms_charges:admin
phone:read:user:admin

**Recording**
cloud_recording:read:list_user_recordings:admin

**Report**
report:read:admin
report:read:list_meeting_participants:admin
report:read:list_meeting_polls:admin
report:read:list_users:admin
report:read:list_webinar_polls:admin
report:read:meeting_qna:admin
report:read:meeting_survey:admin
report:read:meeting:admin
report:read:operation_logs:admin
report:read:telephone:admin
report:read:upcoming_meetings_webinars:admin
report:read:user_activities:admin
report:read:user:admin
report:read:webinar_qna:admin
report:read:webinar:admin

**Role**
role:read:list_members
role:read:list_roles:admin
role:read:role:admin

**SCIM**
scim2

**Team Chat**
team_chat:read:channel:admin
team_chat:read:list_channels:admin
team_chat:read:list_members:admin
team_chat:read:list_user_channels:admin
team_chat:read:list_user_messages:admin
team_chat:read:list_user_sessions:admin
team_chat:read:user_message:admin **Account**
account:read:settings:admin
account:read:settings:master

**Group**
group:read:list_groups:admin
group:read:list_members:admin

**User**
user:read:list_assistants:admin
user:read:list_collaboration_devices
user:read:list_schedulers:admin
user:read:list_users:admin
user:read:settings:admin
user:read:user:admin

**Webinar**
webinar:read:list_panelists:admin
webinar:read:list_registrants:admin
webinar:read:list_webinars:admin
webinar:read:past_qa:admin
webinar:read:webinar:admin

**Whiteboard**
whiteboard_collaborator:read:admin
whiteboard_content:read:admin
whiteboard:read:admin
whiteboard:read:list_collaborators:admin
whiteboard:read:list_sessions:admin
whiteboard:read:list_whiteboards:admin
whiteboard:read:session:admin
whiteboard:read:whiteboard:admin

**Zoom Rooms**
zoom_rooms:read:list_rooms:admin
zoom_rooms:read:room:admin
zoom_rooms:read:list_locations:admin
zoom_rooms:read:location:admin

**Zoom Events**
zoom_events:read:event_registration:admin
zoom_events:read:list_coeditors:admin
zoom_events:read:list_events:admin
zoom_events:read:list_session_attendees:admin
zoom_events:read:list_session_surveys:admin
zoom_events:read:list_speakers:admin
zoom_events:read:list_tickets:admin
11. **Note:**

When creating your app, if you don't see the expected scopes in the Zoom Marketplace:

- Confirm your user role has access to all licenses within Zoom Enterprise.
    - If scopes remain unavailable, it's probable your enterprise version doesn't have the appropriate licensing.
12. Click **Done**.
13. Click **Continue** to proceed in the wizard.
14. Click on **Activate App** to proceed with the activation of the app

**In the Relyance AI application:**

1. Login to your Relyance tenant
2. Navigate to the **Settings** (bottom-left corner)
3. Select **Integrations**
4. Search and locate the **Zoom** integration card and click on it
5. Click on the **Add Connection** button on the top right
6. Provide a meaningful name for the integration and click on the **Add** button
7. In the **Overview** section, select the integration features you wish to enable for the integration (**Data Inspection, Data Subject Requests**), review the **Scope and Permission**, and **Endpoint** details and click on **Continue.** **For More details see**[**Integrations Features**](/docs/introduction-to-relyance-ai/integration-features/)
8. In the **Connection** section, provide the appropriate values and click on **Continue**,
    - **Connection Name**: This property allows you to update the integration specified in Step 6. If you have multiple integrations for the same vendor, you may want to assign distinct names to each. This helps streamline filtering by **Discovery Source** across the **Inventory**, **Visual** **Maps**, **Assets**, and **Data Flow Analysis** pages.
    - **Rescan Frequency**: This property allows you to configure how often Relyance executes scans against this Vendor connection.
    - **Business Atlas Associations** (required): the business entities or products that newly discovered third parties, services and assets from this integration are attributed to. Choose at least one from the **Select Associations** dropdown — the wizard will not advance past this step without one. For more details, see [Business Atlas](/docs/other-settings/business-atlas-overview/).
9. In the Authentication section, provide the **Account ID**, **Client ID**, and **Client Secret** into their respective fields
10. If the Data Inspection check box is checked from step 7, In the Data Inspection section, provide the appropriate values and click on **Continue**
    - **Minimum Confidence Level:** This property adjusts the sensitivity of the Data Inspection feature. Lower likelihoods (e.g., unlikely) offer more coverage but may produce false positives, while higher sensitivity (e.g., very likely) provides greater accuracy but less coverage.
11. Review the configuration summary from the Completion section and click on **Finish**.
12. Confirm the integration Status reflects Connected

![Screenshot](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182813217165.png)

### **Creating an OAuth2 App in Zoom:**

1. Login to your Zoom account.
2. On the side menu click **Advanced** and then **App MarketPlace**.
3. In the top right corner click on the **Develop** dropdown and select **Build App**.

![Zoom-2.png](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182813212557.png)

**Note**: If you've already created an app then click on the **Manage** link *beside* the drop-down.
4. Choose **General App** in the resulting dialog and click **Create**.
5. This will open up a new App. Provide a meaningful name in the top left-hand corner (e.g. Relyance Scan).
6. Ensure the manage type is **Admin-managed** and click on Save.
7. Copy the **Client ID** and **Client Secret** to be used in Relyance.
8. In the OAuth Information section, enter this value into the **OAuth Redirect URL**: [https://root.relyance.ai/api/oauth2](https://root.relyance.ai/api/oauth2)
9. Below this, ensure you add this URL to the **OAuth Allow Lists**: [https://root.relyance.ai/api/oauth2](https://root.relyance.ai/api/oauth2)
10. Click **Scopes** from the left-hand navigation menu.
11. Click on the **Add Scopes** button
12. The list of scopes that should be added is here: **Contact Center**
 contact_center_inbox:read:admin
 contact_center_queue:read:admin
 contact_center_recording:read:admin
 contact_center_region:read:admin
 contact_center_skill:read:admin
 contact_center_user:read:admin
 contact_center:delete:queue_supervisor:admin
 contact_center:read:inbox_user:admin
 contact_center:read:list_address_book_contacts:admin
 contact_center:read:list_address_books:admin
 contact_center:read:list_engagements:admin
 contact_center:read:list_inboxes:admin
 contact_center:read:list_queue_agents:admin
 contact_center:read:list_queues:admin
 contact_center:read:list_recordings:admin
 contact_center:read:list_region_users:admin
 contact_center:read:list_regions:admin
 contact_center:read:list_skill_users:admin
 contact_center:read:list_skills:admin
 contact_center:read:list_users:admin
 contact_group:read:list_groups:admin
 contact_group:read:list_members:admin **Account**
 account:read:settings:admin
 account:read:settings:master **Contact Group**
 contact_group:read:list_groups:admin
 contact_group:read:list_members:admin **Dashboard** dashboard:read:chat:admin dashboard:read:list_meeting_participants_qos:admin dashboard:read:list_meeting_participants:admin dashboard:read:list_meetings:admin
 dashboard:read:list_webinar_participants_qos:admin dashboard:read:list_webinars:admin dashboard:read:meeting_sharing:admin dashboard:read:meeting:admin dashboard:read:zoomroom:admin **Device** device:read:list_groups:admin device:read:list_zdm_devices:admin **Mail** email:read:list_setting_filters email:read:profile:admin email:read:setting_filter:admin **Groups** group:read:list_groups:admin **Marketplace** marketplace:read:app_request:admin marketplace:read:app:admin marketplace:read:list_apps:admin **Meetings** meeting:read:list_meetings:admin meeting:read:list_past_instances:admin meeting:read:list_past_participants:admin meeting:read:list_poll_results:admin meeting:read:list_registrants:admin meeting:read:list_summaries:admin meeting:read:meeting:admin meeting:read:past_meeting:admin meeting:read:summary:admin **Phone** phone:read:call_log:admin phone:read:list_call_logs:admin phone:read:list_call_pickup_groups:admin phone:read:list_call_recordings:admin phone:read:list_external_contacts:admin phone:read:list_numbers:admin phone:read:list_recordings:admin phone:read:list_shared_line_appearances:admin phone:read:list_tracked_locations:admin phone:read:list_users:admin phone:read:list_voicemails:admin phone:read:role_member:admin phone:read:sms_charges:admin phone:read:user:admin **Recording**
 cloud_recording:read:list_user_recordings:admin **Report** report:read:admin report:read:list_meeting_participants:admin report:read:list_meeting_polls:admin report:read:list_users:admin report:read:list_webinar_polls:admin report:read:meeting_qna:admin report:read:meeting_survey:admin report:read:meeting:admin report:read:operation_logs:admin report:read:telephone:admin report:read:upcoming_meetings_webinars:admin report:read:user_activities:admin report:read:user:admin report:read:webinar_qna:admin report:read:webinar:admin **Role** role:read:list_members role:read:list_roles:admin role:read:role:admin **Zoom Rooms** zoom_rooms:read:list_rooms:admin zoom_rooms:read:list_locations:admin **SCIM** scim2 **Team Chat** team_chat:read:channel:admin team_chat:read:list_channels:admin team_chat:read:list_members:admin team_chat:read:list_user_channels:admin team_chat:read:list_user_messages:admin team_chat:read:list_user_sessions:admin team_chat:read:user_message:admin **Group** group:read:list_groups:admin group:read:list_members:admin **User** user:read:list_assistants:admin user:read:list_collaboration_devices user:read:list_schedulers:admin user:read:list_users:admin user:read:settings:admin user:read:user:admin **Webinar** webinar:read:list_panelists:admin webinar:read:list_registrants:admin webinar:read:list_webinars:admin webinar:read:past_qa:admin webinar:read:webinar:admin **Whiteboard** whiteboard_collaborator:read:admin whiteboard_content:read:admin whiteboard:read:admin whiteboard:read:list_collaborators:admin whiteboard:read:list_sessions:admin whiteboard:read:list_whiteboards:admin whiteboard:read:session:admin whiteboard:read:whiteboard:admin **Zoom Rooms** zoom_rooms:read:list_rooms:admin zoom_rooms:read:room:admin **Zoom Events** zoom_events:read:event_registration:admin zoom_events:read:list_coeditors:admin zoom_events:read:list_events:admin zoom_events:read:list_session_attendees:admin zoom_events:read:list_session_surveys:admin zoom_events:read:list_speakers:admin zoom_events:read:list_tickets:admin
13. Click **Done**.
14. Click **Continue** to proceed in the wizard.
15. On the following page you are finished. (You **do not need** to click **Add App Now** .)

![image (1).png](https://assets.relyanceuat.xyz/images/docs/37182813224845/37241574751629.png)

![Screenshot](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182800495245.png)
![Zoom-9.png](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182813212685.png)

![Screenshot](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182813212941.png)

![Zoom-8.png](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182800493709.png)

![Screenshot](https://assets.relyanceuat.xyz/images/docs/37182813224845/37183529496717.png)

**In the Relyance AI application:**

1. Login to your Relyance account.
2. Navigate to the **Settings** (bottom-left corner).
3. Select **Integrations**.
4. Search and locate the **Zoom** integration card and click on it.
5. Click on the **Add Connection** button on the top right
6. Provide a meaningful name for the integration and click on the **Add** button
7. In the **Overview** section, select the integration features you wish to enable for the integration, review the **Scope and Permission**, and **Endpoint** details and click on **Continue**. For more details see: [Integration Features](/docs/introduction-to-relyance-ai/integration-features/)
8. In the **Connection** section, provide the appropriate values and click on **Continue**,
    - **Connection Name**: This property allows you to update the integration specified in Step 6. If you have multiple integrations for the same vendor, you may want to assign distinct names to each. This helps streamline filtering by **Discovery Source** across the **Inventory**, **Visual** **Maps**, **Assets**, and **Data Flow Analysis** pages.
    - **Rescan Frequency**: This property allows you to configure how often Relyance executes scans against this Vendor connection.
    - **Business Atlas Associations** (required): the business entities or products that newly discovered third parties, services and assets from this integration are attributed to. Choose at least one from the **Select Associations** dropdown — the wizard will not advance past this step without one. For more details, see [Business Atlas](/docs/other-settings/business-atlas-overview/).
9. In the Authentication section, provide the **Client ID**, and **Client Secret** into their respective fields
10. If the Data Inspection check box is checked from step 7, In the Data Inspection section, provide the appropriate values and click on **Continue**
    - **Minimum Confidence Level:** This property adjusts the sensitivity of the Data Inspection feature. Lower likelihoods (e.g., unlikely) offer more coverage but may produce false positives, while higher sensitivity (e.g., very likely) provides greater accuracy but less coverage.
11. Review the configuration summary from the Completion section and click on **Finish**

![Screenshot](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182813217421.png)

![Screenshot](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182813217933.png)

![Screenshot](https://assets.relyanceuat.xyz/images/docs/37182813224845/37182813219213.png)

<!-- terraform-examples:begin (generated from the integration catalog; do not hand-edit) -->

## Manage this integration with Terraform

Connections for this integration can be managed as code with the [Relyance Terraform provider](https://registry.terraform.io/providers/Relyance/relyance/latest). Non-secret fields go in `auth.params`; secret fields go in `auth.secrets_wo`, which is write-only — never stored in Terraform state. Rotate secrets by bumping `auth.secrets_wo_version`.

### OAuth (browser authorization)

The **OAuth (browser authorization)** method uses a browser authorization flow, so the connection is created in the Relyance app. Manage it in Terraform afterwards by importing it (`terraform import relyance_integration_connection.example zoom/<connection_id>`) or reading it with the `relyance_integration_connection` data source.

### OAuth client credentials

```hcl
resource "relyance_integration_connection" "zoom_1" {
  vendor = "zoom"
  name   = "<your connection name>"

  auth = {
    method = "oauth-client-credentials"
    params = {
      account_id = "<account_id>"
      client_id = "<client_id>"
      data_storage_location = "us"
    }
    # Secret fields are write-only: sent to Relyance, never stored in state.
    secrets_wo = {
      client_secret = var.zoom_client_secret
    }
    secrets_wo_version = 1
  }

  scans = { "data-inspection" = { enabled = true } }
}
```

<!-- terraform-examples:end -->
