--- title: "Collect Zoom Data" slug: "collect-zoom-data" status: "new" updated: 2026-10-16T14:28:20Z published: 2026-10-16T14:28:20Z canonical: "docs.revealdata.com/collect-zoom-data" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.revealdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Collect Zoom Data The **Zoom** integration allows organizations to collect Zoom data from custodians as part of a legal hold. Administrators can configure the integration at the subscription level, create a Zoom collection location, and enable collections for individual holds. Collections are processed through Onna, with their status tracked in Reveal Hold. ## Create a Zoom integration A System Administrator can configure the Zoom integration from the subscription settings. 1. Navigate to **Admin Center > Subscription > Integrations**. 2. Click ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/create-integration-button.png). 3. In the **Integration Type** dropdown, select **Zoom.** 4. Select the **Tenant** and click **Next**. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/cREAte-integrationn.png) 5. In the Zoom sign-in window, enter the Zoom administrator’s email address and password, then click **Sign In**. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/zoom-collection.png) 6. If two-step verification is enabled, enter the code from your authenticator app and click **Verify**. 7. Grant the requested permissions to authorize the integration. 8. Return to Reveal Hold and click **Save**. A confirmation message indicates that the Zoom integration was saved successfully. The integration appears in the **Integrations** grid with its status set to **Enabled**. > [!WARNING] > Important > > A Zoom integration created before this feature was released does not have legal hold access. Edit it and repeat the Zoom sign-in, otherwise preservation will fail. ## Create a Zoom collection location After configuring the integration, create a location to identify the Zoom source for collection. 1. Navigate to **Admin Center > Subscription > Locations**. 2. Click ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/create-location-button(1).png). 3. Enter a **Name** for the location. 4. Under **Preservation Type**, select **Zoom**. 5. Verify that **Zoom** is displayed as the **Source**. 6. Select the **Tenant** and click **Save**. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/preserve-location-zoom.png) The new location appears in the Locations grid. > [!NOTE] > Note > > Only tenants with an existing Zoom integration are available for selection. ## Configure Zoom collection settings Once the Zoom integration and location are configured, you can enable Zoom collection for a hold. 1. Create or open a hold and add the custodians whose Zoom data needs to be collected. - The custodian's email in the Address Book must be the same as their Zoom user email (the email they sign in to Zoom with). Capital letters do not matter. If the email does not match a Zoom user, the custodian shows Not Present and nothing is held in Zoom. 2. Navigate to the **Collection** tab. 3. Click **Edit Collection Settings**. 4. Verify that **Onna** is selected as the **Target Location**. 5. Under **Collection Locations**, enable **Zoom**.![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/image%20(12).png) 6. Enable **Auto-Sync** if the collected data should continue to be updated. 7. Click **Save**. The Zoom collection location appears on the Collection tab, displaying the number of custodians with **Done**, **In Progress**, **To Do**, and **Failed** statuses. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/collection-tab.png) To start collecting Zoom data for the custodians included in the hold, click **Start Collection**. After the confirmation dialog appear, click **Yes**. This will starts the collection in Onna. The Collection Status initially displays **Not Collected** until the collection is completed. To start a collection for an individual custodian, click the **Start** icon ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/start-icon.png) in the corresponding custodian row. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/collection-tab-status.png) Reveal Hold retrieves Zoom collection statuses through the Onna integration. These statues can be: | Status | What it means | | --- | --- | | Not Collected | Collection has not started for this custodian yet. | | Automatic Collection Pending | Reveal Hold asked Zoom for the data and is waiting for a response. | | Collected Automatically | The custodian was found in Zoom and their data was collected successfully. The **Delete** action is available | | Collected Manually | A user manually marked the Zoom location as collected for this custodian. | | Not Present | No Zoom user has the custodian's email address. There is nothing to collect; this is not an error. The available actions are **Exclude**, **Set to Collected**, and **Retry** | | Excluded | The Zoom location was excluded for this custodian before collection started. | | Failed | The collection request failed. The error appears under Health Status > Activity Errors. After resolving the issue, the collection can be retried from the Activity or Collection grid. | Use the collection status and available actions to manage individual custodian collections.