CLOSE.AIBack to home

Documentation

The 1Close Zoom integration.

Last updated: Apr 29, 2026

1Close uses Zoom as a data integration only. After your meeting ends, we pull the cloud recording and transcript from Zoom and run it through our scoring methodology. We never join your meeting as a participant, never post on your behalf, and never use Zoom to log you in.

Before you install

  • You need a 1Close account. Sign up at 1close.ai.
  • Your Zoom plan must include Cloud Recording. We do not process local recordings.
  • We recommend enabling Audio Transcript in your Zoom recording settings so transcripts are generated automatically.

Install the integration

  1. Sign in to 1Close.
  2. Open Settings → Integrations.
  3. Click Connect Zoom. You will be redirected to Zoom to approve the connection.
  4. Review the scopes we request, then click Allow.
  5. You will be returned to 1Close. The integration is now active.

From this point on, every cloud-recorded Zoom meeting on your account will be pulled into 1Close automatically once Zoom finishes processing the recording (usually a few minutes after the call ends).

OAuth scopes we request

We request the minimum scopes required to deliver the product:

  • meeting:read— read meeting metadata (start time, duration, host, participants) so we can match a recording to the right deal in your pipeline.
  • recording:read— read your own meeting recordings and transcripts so we can score the call.
  • user:read— read your Zoom user profile so we know which Zoom account is connected to which 1Close user.

We do notrequest scopes to write to Zoom, create meetings, modify your account, or access other users' data.

How a call flows through 1Close

  1. You finish a Zoom meeting that was cloud-recorded.
  2. Zoom processes the recording and transcript (typically a few minutes).
  3. Zoom sends us a recording.transcript_completed webhook.
  4. We verify the webhook signature, then fetch the transcript using your stored OAuth token.
  5. We match the call to a deal in your pipeline (or create a placeholder if no match is found).
  6. The transcript is scored against our methodology and the result appears in the deal.

What data we store

  • Your encrypted Zoom OAuth access and refresh tokens.
  • Meeting metadata (ID, title, time, host email, participant emails).
  • The transcript text, stored as plain text.
  • The scoring output produced by our methodology.

We do not store the audio or video recording itself. The recording stays in Zoom under your account; we only fetch it transiently to extract the transcript.

For full detail on storage location, retention, and your rights, see our Privacy Policy.

Disconnect the integration

You can disconnect at any time, from either side:

From inside 1Close

  1. Open Settings → Integrations.
  2. Find the Zoom card and click Disconnect.
  3. We immediately stop fetching new recordings. Your existing scored calls remain in your account.

From inside Zoom

  1. Sign in to marketplace.zoom.us.
  2. Open Manage → Installed Apps.
  3. Find 1Close and click Remove.
  4. Zoom revokes our access immediately and sends us a deauthorisation webhook. We delete the associated OAuth tokens within 7 days, as required by the Zoom Marketplace data compliance policy.

To delete the historical scored data as well, email help@1close.ai and we will action the deletion within one business day.

Troubleshooting

My call hasn't appeared

  • Confirm the meeting was cloud-recorded in Zoom (not local).
  • Wait at least 30 minutes — Zoom can take a while to finish transcript processing.
  • Check Settings → Integrations to confirm Zoom is still connected.
  • If the issue persists, email help@1close.ai with the Zoom meeting ID and we will investigate.

The call appeared but wasn't matched to a deal

If we can't find a confident match in your pipeline, the call is created as a placeholder you can manually link to the right deal. Open the call from your Hey dashboard and choose the deal from the dropdown.

I'm seeing a token error

Zoom OAuth tokens occasionally expire if the Zoom account password is changed or the integration is revoked from outside 1Close. Reconnect from Settings → Integrations and the issue will resolve.

Need more help?

Email help@1close.ai. We respond within one business day.