> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/saas-applications/zoom.md).

# Zoom

Harmony's Zoom integration connects your Zoom account to give you full visibility into user activity, license usage, and meeting patterns across your organization. Once connected, Harmony automatically syncs your Zoom data and surfaces it across your application, instance, and user views - helping you optimize licenses, track adoption, and streamline provisioning workflows.

#### What the Zoom integration enables

| Capability              | Description                                                                   |
| ----------------------- | ----------------------------------------------------------------------------- |
| License Optimization    | Track Zoom usage to identify underutilized licenses and reduce costs          |
| Usage Analytics         | Understand meeting patterns, user adoption, and collaboration trends          |
| Automated Provisioning  | Streamline user onboarding and license assignment workflows                   |
| Activity Monitoring     | Monitor sign-in events and per-user activity with up to 90 days of history    |
| License Tier Visibility | See each user's license tier (Paid, Free, or Unknown) alongside activity data |

***

#### Prerequisites

1. **Zoom Business, Education, or Enterprise plan**
2. **Zoom Administrator access** - Account Owner or Admin role is required to authorize the integration
3. **A Harmony account** with admin privileges

***

#### Connect Zoom to Harmony

**Step 1: Navigate to Integrations**

1. Log into your Harmony dashboard
2. Navigate to **Settings** > **Integrations**
3. Find **Zoom** under **SaaS Applications**

**Step 2: Authorize Zoom**

1. **Initiate the connection**

   1. Click the **Zoom** integration card
   2. Click **Connect**

   A Zoom authorization modal will open.
2. **Authorize in Zoom**

   Sign in with your Zoom administrator account if prompted.

   1. Review the permissions Harmony is requesting (see [Permissions Explained](#permissions-explained) below)
   2. Click **Allow** to authorize the connection
   3. The modal closes automatically and you are returned to Harmony

   Once authorized, Harmony begins syncing your Zoom data. The initial sync may take a few minutes depending on your organization size. Up to 90 days of historical sign-in activity is pulled in on the first connection, and your user inventory refreshes automatically every 6 hours to reflect any changes.

***

#### Disconnect Zoom from Harmony

1. Log into your Harmony dashboard
2. Navigate to **Settings** > **Integrations**
3. Find **Zoom** under **SaaS Applications** and click the integration card
4. Click **Disconnect**
5. Confirm the disconnection when prompted

Once disconnected, Harmony stops syncing data from Zoom. Previously synced data remains available in Harmony.

***

#### What Harmony Syncs from Zoom

| Data            | Description                                                          |
| --------------- | -------------------------------------------------------------------- |
| User profiles   | Name, email, department, and role                                    |
| License types   | License tier (Paid, Free, or Unknown) and assignment status          |
| User activity   | Last login date, sign-in events, and per-user activity metrics       |
| Meeting history | Hosted meetings, duration, and participant count                     |
| Usage analytics | Meeting frequency and hosting patterns per user                      |
| Plan details    | Account-level plan information surfaced in the application dashboard |

{% hint style="info" %}
**Where to find Zoom data in Harmony:**

* **Applications** - Zoom appears as a discovered application with license and usage details, including activity metrics at the application and instance level
* **People** - Each employee's profile shows their Zoom license tier, role, last activity, and per-user meeting hosting data
  {% endhint %}

{% hint style="info" %}
**Historical data on first connection:**

Harmony pulls up to 90 days of historical sign-in activity when you first connect Zoom. After that, sign-in events are kept in sync automatically.
{% endhint %}

***

#### Permissions Explained

**Required scopes**

| Scope                               | Description                         | Purpose                                                                                            |
| ----------------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------- |
| `user:read:user:admin`              | View a user                         | Identify the Zoom account and read individual user profiles                                        |
| `user:read:list_users:admin`        | View users                          | List all active users for inventory sync                                                           |
| `report:read:user:admin`            | View a user's usage reports         | Collect per-user meeting host reports - number of meetings hosted, duration, and participant count |
| `report:read:user_activities:admin` | View user sign in/out activity logs | Track sign-in activity and last login dates                                                        |

**Optional scopes**

| Scope                                 | Description            | Purpose                                                                                                                                                                                                                               |
| ------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `billing:read:user_entitlement:admin` | View user entitlements | Read license tier and entitlement per user (Paid, Free, or Unknown). Enables license optimization - identifying underutilized paid licenses and tracking cost. Without this scope, users are synced but their license tier is unknown |

***

#### Use Cases

<details>

<summary>License Optimization</summary>

Identify unused and underutilized licenses, automatically reclaim seats from inactive users, and reduce Zoom costs. Each user's license tier (Paid, Free, or Unknown) is visible alongside their activity data so you can make informed decisions about reassignment.

</details>

<details>

<summary>Automated Provisioning</summary>

Assign Zoom licenses based on department or role during onboarding and revoke them automatically during offboarding.

</details>

<details>

<summary>Usage Insights</summary>

Track adoption by department, analyze meeting trends, and make data-driven decisions about your Zoom investment. Per-user activity metrics - such as meeting hosting frequency and duration - are surfaced at the user, instance, and application level in your Harmony dashboard.

</details>

<details>

<summary>User Activity Monitoring</summary>

Monitor sign-in events across your organization with up to 90 days of historical activity available from the moment you connect. Harmony refreshes your Zoom user inventory every 6 hours so your data stays current as users are added, removed, or change roles.

</details>

***

#### Troubleshooting

<details>

<summary>Data is not appearing after connection</summary>

**Possible causes:**

* The initial sync has not completed yet (may take up to 15 minutes)
* The Zoom account does not have an active Business, Education, or Enterprise plan
* The authorizing user does not have Admin or Owner permissions

**Solutions:**

1. Wait up to 15 minutes for the initial sync to complete
2. Verify your Zoom plan in the Zoom Admin Console under **Account Management**
3. Reconnect the integration with a user that has Admin or Owner permissions

</details>

<details>

<summary>Meeting data is incomplete</summary>

**Possible causes:**

* Zoom provides meeting reports for the past 90 days only

**Solutions:**

1. Meetings older than 90 days are not available through the Zoom API - this is a Zoom platform limitation

</details>

<details>

<summary>License tier shows as Unknown</summary>

**Possible causes:**

* The `billing:read:user_entitlement:admin` scope was not granted during authorization

**Solutions:**

1. Disconnect and reconnect the Zoom integration, ensuring you grant the optional billing scope when prompted
2. Without this scope, users are synced but their license tier cannot be determined

</details>

***

#### Data & Privacy

<details>

<summary>Key privacy principles</summary>

For information about how Harmony handles your data, see our [Privacy Policy](https://harmony.io/privacy).

* Harmony accesses Zoom data in read-only mode and does not modify any data in your Zoom account
* Integration can be revoked at any time from Zoom or Harmony settings

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.harmony.io/integrations/saas-applications/zoom.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.