Skip to main content

Zoom App integration

The ScribX app for Zoom connects your Zoom account to ScribX so that meetings are captured, transcribed and summarized with less friction: the ScribX notetaker can receive recording permission automatically and join on your behalf.

This page covers everything you need: adding the app, using each feature, removing the app and troubleshooting.

Screenshot placeholder
📷 To capture: the Zoom App integration setup screen (target: /img/handbook/integrations/zoom-app.png).
Just want your Zoom meetings recorded?

You don't need this integration for that — sending a bot works out of the box with no account connection. Connect the Zoom app when you want automatic recording permission or on-behalf join.

Adding the app

Prerequisites

  • A ScribX account that is a member of at least one team (sign up if you don't have one).
  • A Zoom account (any plan). If your Zoom admin restricts app installs, they may need to pre-approve ScribX on the Zoom Marketplace first.

Steps

  1. Sign in to ScribX and open Team Settings → Integrations.
  2. In the Zoom section, click Connect your Zoom.
  3. You are redirected to zoom.us to sign in (if you aren't already) and shown the permissions ScribX requests.
  4. Review the permissions and click Allow.
  5. You are redirected back to ScribX. Your Zoom account now appears under Connected accounts in the Integrations tab — that's the whole setup.

Each teammate who wants ScribX to act on their own Zoom account repeats these steps with their own Zoom login; connections are per-user and visible across their teams.

Something not working during setup? See Troubleshooting below.

For organization admins

Organization admins choose which Zoom Marketplace app the org connects against, under Organization settings → Meeting platforms → Zoom:

  • ScribX app (default) — the shared ScribX app published on the Zoom Marketplace. No configuration needed; members just connect as described above.
  • Your Zoom app — bring your organization's own Zoom OAuth app instead: enter its Client ID, Client secret and (optionally) webhook secret, then click Connect account. Teams can still override this with a team-level app under Team Settings → Integrations.

Using the integration

Automatic recording permission

Use case: normally, when a bot joins a Zoom meeting, the host must grant it recording permission in-meeting. With a connected Zoom account, ScribX requests a local recording token from Zoom, so the notetaker starts recording without asking the host — and it can bypass the waiting room.

Prerequisites: the meeting is hosted (or the bot is created) by a user whose Zoom account is connected, and that account's plan supports local recording tokens.

Expected outcome: the ScribX notetaker joins, is admitted past the waiting room, and begins recording immediately — no permission prompt for the host.

Joining on your behalf

Use case: ScribX can join with an on-behalf token tied to your connected Zoom account, which improves how the notetaker is identified and admitted in meetings you attend.

Prerequisites: your connected Zoom account supports on-behalf tokens (shown with an OBF badge in the Integrations tab), and you're a participant in the meeting. When several teammates are connected, ScribX prefers the account of the person who scheduled the notetaker, then the meeting host, then the team default.

Expected outcome: the notetaker joins associated with your account instead of as a fully anonymous participant.

Meeting recognition

Use case: once connected, ScribX learns about meetings you create (via Zoom's meeting.created event and a periodic sync of your upcoming meetings) so your meetings are matched to your account automatically — this is what makes the two features above pick the right person.

Prerequisites: none beyond a connected account; this happens in the background.

Expected outcome: meetings you host are attributed to your connection; no visible UI beyond correct behavior of the other features.

Removing the app

You can disconnect at any time from the Zoom side:

  1. Sign in to the Zoom App Marketplace.
  2. Click Manage → Added Apps (or visit your installed apps).
  3. Find ScribX and click Remove.

What happens when you remove the app — Zoom notifies ScribX the moment you deauthorize, and ScribX immediately:

  • Deletes your Zoom OAuth tokens. ScribX can no longer access your Zoom account in any way.
  • Deletes the meeting-to-account mappings learned from your Zoom account.
  • Confirms the data deletion back to Zoom (Zoom's data-compliance notification) within 24 hours.

Your ScribX connection is shown as Disconnected afterwards. Recordings, transcripts and summaries that were already captured are not deleted by removing the Zoom app — they belong to your ScribX workspace and follow your team's data-retention settings, where you can delete them at any time. Meetings simply stop benefiting from the features above; sending a bot keeps working without the integration.

Organization admins using Your Zoom app mode can also remove the org-level app in Organization settings → Meeting platforms → Zoom → Remove app; teams then fall back to the managed ScribX app.

To reconnect later, just repeat Adding the app.

Troubleshooting

  • The Allow screen shows an error or redirects to a broken page — your organization may be in Your Zoom app mode with incomplete credentials. Ask your org admin to check Organization settings → Meeting platforms → Zoom, or switch back to the ScribX app mode.
  • "Connect your Zoom" is missing — you may not have access to the team's Integrations tab; ask a team admin.
  • The notetaker still asks the host for recording permission — the meeting's host isn't a connected account (or the host's Zoom plan doesn't issue local recording tokens). Connect the host's Zoom account, or grant permission in-meeting as usual.
  • Anything else — see the general troubleshooting guide or email support@scribx.app.

What's next?