---
title: Zoom
description: >-
  Consume activity logs, call quality telemetry, and meeting and Zoom Room
  health data from Zoom
breadcrumbs: Docs > Integrations > Zoom
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Zoom
Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

This integration collects three types of data from your Zoom account: **activity logs**, **meetings** telemetry (including call quality), and **Zoom Room** health. Together they give you visibility into user activity, communication performance, and room hardware health.

### Activity logs{% #activity-logs %}

Capture activity within your Zoom account to:

- Cross-reference Zoom events with data from other services in your environment.
- Build custom widgets and dashboards with your Zoom event data.
- Set up [Cloud SIEM](https://docs.datadoghq.com/security/cloud_siem.md) detection rules using the out-of-the-box logs pipeline.

Datadog's Zoom integration collects logs using [sign in and sign out activities](https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/reportSignInSignOutActivities) and [operation logs](https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/reportOperationLogs), which provide insight into admin and user activity, including:

- Adding a new user
- Changing account settings
- Deleting recordings
- Sign in and sign out activities

### Meetings and call quality{% #meetings-and-call-quality %}

Track meeting-level activity, participation, and call quality across your Zoom account.

#### Meetings{% #meetings %}

Track meeting-level activity and participation across your Zoom account to:

- Monitor meeting volume and participation trends over time.
- Identify users experiencing poor call quality.
- Identify meetings where a disproportionate number of participants fall below quality thresholds.

#### Call quality{% #call-quality %}

If you have [End User Device Monitoring](https://docs.datadoghq.com/infrastructure/end_user_device_monitoring.md) enabled, Datadog captures audio and video quality telemetry directly from Zoom calls, letting you:

- Monitor jitter, latency, packet loss, and bitrate in real time to detect degraded call quality before users complain.
- Combine call quality data with device and network telemetry to see end-to-end what's affecting call quality.
- Pinpoint whether issues stem from a specific user, meeting, device, or network segment.
- Correlate Zoom call quality with infrastructure events happening elsewhere in your environment.
- Track quality trends over time to identify recurring issues by time, location, or user.

### Zoom Rooms{% #zoom-rooms %}

Track the health and status of your Zoom Rooms to:

- Be alerted when a room goes offline or reports a hardware or network issue.
- Monitor room status and issue trends across locations over time.
- Identify rooms that need maintenance before they disrupt a meeting.

Independent of the other data sources — can be enabled with or without **Meeting quality**.

## Setup{% #setup %}

### In Zoom{% #in-zoom %}

Before authorizing, confirm your Zoom account meets the requirements for the data types you want to collect:

- **Admin privileges**: The authenticating user must have **account owner or admin permissions**, or a custom role that includes permission to view **User Activity Reports** and access the Admin Activity Log for all users. If you select **Meeting quality** or **Zoom Room quality**, the custom role must also include access to the relevant **Dashboard** reports. Activity Logs permissions alone do not authorize the Dashboard API calls that these data sources rely on.
- **Activity logs** require a **Pro, Business, Enterprise, or Education** account.
- **Meetings** require a **Business, Enterprise, or Education** account.
- **Zoom Rooms** require a **Business, Education, or API** plan with at least one room configured.

If you have questions regarding your Zoom account permissions, reach out to [Zoom Support](https://support.zoom.com/hc/en). For more details on the specific reports Datadog consumes, see:

- [Zoom User Activity Reports](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0060623)
- [Zoom Admin Activity Logs Report](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0067251)
- [Zoom Operation Logs Report](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0059308#:~:text=How%20to%20view%20Zoom%20Contact,then%20Contact%20Center%20Operation%20Logs)

### In Datadog{% #in-datadog %}

1. On the Zoom tile, click **Add Account**.

1. In the **Add Zoom Account** dialog, select which data source(s) to collect:

   - **Activity logs**: sign-in events and admin operation logs through the Zoom Report API.
   - **Meeting quality**: Dashboard metrics and per-participant quality of service (QoS) through the Zoom Dashboard API. Requires a Business, Enterprise, or Education plan.
   - **Zoom Room quality**: Room health, status, and issue metrics through the Zoom Dashboard API. Requires a Business, Education, or API plan with Zoom Rooms set up.

1. Click **Authorize** and sign in with the admin account above.

Data sources are set at authorization and can't be changed afterward. To change data sources on an existing account, delete it and add a new one with the desired selections.

## Permissions{% #permissions %}

Datadog for Zoom requires the following OAuth Scopes. For more information, see the [Zoom OAuth scopes documentation](https://developers.zoom.us/docs/integrations/oauth-scopes-granular/#reports).

### User-level scopes{% #user-level-scopes %}

#### Activity logs{% #activity-logs-1 %}

| Scopes                              | Request Reason                                                                                                            |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `report:read:user_activities:admin` | Read sign in / sign out activity logs of users under a Zoom account.                                                      |
| `report:read:operation_logs:admin`  | Read admin operation logs including events such as adding a new user, changing account settings, and deleting recordings. |

#### Meetings{% #meetings-1 %}

| Scopes                                               | Request Reason                                                                                                          |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `dashboard:read:list_meetings:admin`                 | List meetings from the Zoom Dashboard API, used to enumerate meetings and their participants for quality reporting.     |
| `dashboard:read:list_meeting_participants_qos:admin` | Read per-participant quality of service (QoS) metrics, including audio/video latency, jitter, packet loss, and bitrate. |

#### Zoom Rooms{% #zoom-rooms-1 %}

| Scopes                                | Request Reason                                                                            |
| ------------------------------------- | ----------------------------------------------------------------------------------------- |
| `dashboard:read:list_zoomrooms:admin` | List Zoom Rooms and their current health, status, and issues from the Zoom Dashboard API. |

Only the scopes for the data source(s) selected during authorization are requested. Data sources can't be changed after authorization — to select different ones, delete the account and add a new one.

### Removing the app{% #removing-the-app %}

To uninstall the Zoom integration, navigate to the Zoom tile and delete any existing accounts that appear in the account table.

## Data collected{% #data-collected %}

### Metrics{% #metrics %}

When the **Meeting quality** data type is enabled, the integration emits per-session call quality metrics. When **Zoom Room quality** is also enabled, it additionally emits room health and issue metrics.

|  |
|  |
| **zoom.meeting.latency**(gauge)        | Round-trip latency for a meeting session*Shown as millisecond*         |
| **zoom.meeting.jitter**(gauge)         | Audio/video jitter for a meeting session*Shown as millisecond*         |
| **zoom.meeting.avg_loss_pct**(gauge) | Average packet loss percentage for a meeting session*Shown as percent* |
| **zoom.meeting.max_loss_pct**(gauge) | Maximum packet loss percentage for a meeting session*Shown as percent* |
| **zoom.meeting.bitrate**(gauge)        | Bitrate for a meeting session (kbps)                                   |
| **zoom.room.issue**(gauge)             | Whether a Zoom Room currently has an active issue (1) or not (0)       |

Meeting quality metrics are tagged with `source:zoom-meeting-quality`, and Zoom Room metrics are tagged with `source:zoom-room-quality`. Activity logs do not emit any metrics.

### Service checks{% #service-checks %}

The Zoom integration does not include any service checks.

### Logs{% #logs %}

Zoom collects data from Zoom's [Sign In and Out Activity Log](https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/reportSignInSignOutActivities) and [Operation Log](https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/reportOperationLogs) endpoints.

### Events{% #events %}

Zoom integration does not include any events.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).