Skip to content

Zoom app

Zoom setup guide

Add, use, and remove the Arena Zoom app — connect your account, run workflows, and uninstall.

Documentation / Zoom

Arena connects your Zoom account to AI workflows so you can schedule meetings, manage recordings, and react to Zoom events automatically. Once the Arena app is authorized, your workflows can create, update, and cancel meetings; read meeting and recording data; start from Zoom events; and sync transcripts into a knowledge base.

Before you begin

You need:

  • An Arena account and a workspace where you have Write or Admin permission.
  • A Zoom account. To grant the requested scopes, sign in as the Zoom user whose meetings and recordings the workflows should use. Some Zoom accounts require a Marketplace admin to pre-approve the app before you can authorize it.

Adding the app

You can add Arena from the Zoom App Marketplace or from Arena. Both paths authorize the same OAuth app and grant the same permissions.

Add from Arena

  1. Log in at app.thearena.ai, open your workspace, and click Integrations in the sidebar.
  2. Search for Zoom and open it, then click + Add to Arena.
  3. In the Connect Zoom dialog, enter a Display name (for example "Work Zoom"), review the permissions requested, and click Connect.
  4. You are redirected to Zoom. Sign in if prompted, review the requested permissions, and click Allow.
  5. You are returned to Arena. The connection appears under Connected on the Integrations page.

You can connect more than one Zoom account and choose per workflow which one to use.

Add from the Zoom App Marketplace

  1. Open the Zoom App Marketplace and sign in.
  2. Search for Arena, open the listing, and click Add.
  3. Review the permissions Arena requests and click Allow.
  4. Zoom redirects you to Arena. Sign in if you are not already signed in, then finish connecting the account in your workspace.

If your Zoom admin has not pre-approved Arena, Zoom may ask you to request approval instead of completing authorization. Ask an admin to pre-approve the app, then try Add again.

Permissions requested

Arena requests only the Zoom scopes it needs to run the Zoom block and triggers:

ScopeWhy Arena needs it
user:read:userIdentify the connected Zoom user
meeting:write:meetingCreate meetings
meeting:read:meetingGet meeting details
meeting:read:list_meetingsList a user's meetings
meeting:update:meetingUpdate an existing meeting
meeting:delete:meetingCancel or delete a meeting
meeting:read:invitationFetch invitation text
meeting:read:list_past_participantsList participants from a past meeting
cloud_recording:read:list_user_recordingsList cloud recordings
cloud_recording:read:list_recording_filesGet recording files and download URLs
cloud_recording:delete:recording_fileTrash or permanently delete a recording

OAuth tokens are encrypted at rest and refreshed automatically. They are not shown in the workflow editor, logs, or API responses. How Arena protects the Zoom connection is described in the Zoom Security Policy.

Using the app

Prerequisites

  • The Arena app is added and the Zoom connection appears under Connected.
  • The workflow that should call Zoom is in a workspace you can edit.
  • Triggers only fire after the workflow is deployed.

Use Zoom in a workflow

  1. Open a workflow in the editor and add a Zoom block.
  2. In Zoom Account, select the connection you created.
  3. Pick an Operation and fill in its fields. Reference outputs from earlier blocks with connection tags, such as <agent.content> or <start.input>.
  4. Run the workflow from the editor, on a schedule, from an API call, or from chat.

Every run is recorded in Logs, block by block, so you can verify exactly what was sent to or read from Zoom.

Features and use cases

FeatureWhat it doesTypical use
Create MeetingCreates an instant or scheduled meeting with topic, time, duration, timezone, password, waiting room, and recording optionsBook a follow-up from a CRM deal or a support ticket
List MeetingsLists scheduled, live, upcoming, or previous meetings for a userBuild a daily agenda or find a meeting ID
Get MeetingReturns details for one meeting, including join URL and settingsConfirm a booking before sending a reminder
Update MeetingChanges topic, time, duration, or settings without recreating the meetingReschedule after a conflict
Delete MeetingCancels a meeting or a single occurrence of a recurring seriesClean up cancelled sessions
Get Meeting InvitationReturns the formatted invitation textEmail or Slack the join details
List RecordingsLists cloud recordings for a user in a date range (last 6 months)Find yesterday's calls
Get Meeting RecordingsReturns recording files (video, audio, transcript) and optional downloadsSummarize a call or archive the file
Delete RecordingMoves a recording to trash or deletes it permanentlyRetention and cleanup policies
List Past ParticipantsLists who joined a completed meeting, with join and leave timesAttendance and follow-up

With a personal OAuth connection, user-scoped operations accept me for the connected user. If you switch to a Server-to-Server service account, pass an explicit user ID or email instead — me is not supported.

Start workflows from Zoom events

The Zoom block can also act as a trigger. Toggle Use as Trigger, pick an event, paste your Zoom app Secret Token, save the configuration, then point Zoom at the webhook URL Arena generates.

EventWhen the workflow runs
Meeting StartedA Zoom meeting starts
Meeting EndedA Zoom meeting ends
Participant JoinedSomeone joins a meeting
Participant LeftSomeone leaves a meeting
Recording CompletedA cloud recording is ready
Webhook (All Events)Any Zoom webhook event Arena receives
  1. Copy the Webhook URL from the Zoom trigger in Arena.
  2. In the Zoom Marketplace, open your app (or a webhook-only app) and copy the Secret Token from the Features page. Paste it into the trigger's Secret Token field in Arena and save.
  3. In Zoom, go to Features → Event Subscriptions, click Add Event Subscription, and paste the webhook URL as the event notification endpoint. Click Validate.
  4. Add the matching event (for example meeting.ended or recording.completed) and save the subscription.
  5. Deploy the workflow so the endpoint is live.

Admin approval may be required for account-level webhooks. Arena verifies Zoom's signature with the secret token; requests that fail verification are rejected.

Sync Zoom transcripts into a knowledge base

From a knowledge base, click + New connector, choose Zoom, select the same OAuth connection, and set an initial lookback (up to 6 months — Zoom only exposes cloud recordings in that window). Arena indexes meeting transcripts so agents can retrieve them later.

Removing the app

You can disconnect Arena from your workspace, remove Arena from your Zoom account, or both. Do both if you want to fully revoke access.

What happens when you remove the app

  • Arena immediately loses authorization to call the Zoom API on your behalf. Stored OAuth access and refresh tokens for that connection are deleted.
  • Workflows that use this Zoom connection fail at the Zoom block on their next run. Zoom triggers that depend on it stop firing.
  • Meetings, recordings, users, and other data in Zoom are not changed or deleted. Removing the app does not cancel meetings or erase cloud recordings.
  • Workflow definitions, execution logs of past runs, and knowledge-base documents already synced from Zoom remain in Arena until you delete them yourself.
  • To use Zoom in Arena again, add the app and reconnect, then point your Zoom blocks at the new connection.

Disconnecting or uninstalling does not delete your Zoom meetings or recordings. It only revokes Arena's access. If you also want synced transcripts removed from a knowledge base, delete that connector (and optionally its documents) in Arena.

Disconnect Zoom from Arena

  1. In Arena, click Integrations in the sidebar.
  2. Under Connected, open your Zoom connection.
  3. Click Disconnect, and confirm.

Remove the app from your Zoom account

  1. Log in to your Zoom account and navigate to the Zoom App Marketplace.
  2. Click Manage → Added Apps, or search for the Arena app.
  3. Select the Arena app.
  4. Click Remove. In the Remove App window you can optionally select a reason, then confirm.

Zoom then sends Arena a deauthorization notification. Arena deletes the stored tokens for that Zoom user so the connection can no longer be used. See Zoom's help article on uninstalling apps for account-admin options.

Troubleshooting

  • Authorization fails or Zoom asks for admin approval. Your Zoom account may require a Marketplace admin to pre-approve Arena. Ask an admin to pre-approve the app, then add it again.
  • The Connect button returns an error. Confirm you completed Zoom's Allow screen, that pop-ups or redirects are not blocked, and that you are signed into the intended Zoom account.
  • A Zoom block fails with an authorization error. The connection may have been disconnected or the app removed in Zoom. Open Integrations, check the connection, and reconnect it.
  • Create Meeting fails with an error about me. You are using a Server-to-Server service account. Enter the host's Zoom email or user ID instead of me.
  • A meeting is created but participants cannot join. Check the meeting type, start time (ISO 8601), timezone, waiting room, and password on the Create Meeting or Update Meeting block.
  • List Recordings or Get Meeting Recordings returns nothing. Cloud recordings are only available for the last 6 months, and only if cloud recording was enabled for that meeting.
  • A trigger is not firing. Confirm the workflow is deployed, the Secret Token matches the Zoom app's Features page, the event subscription validated successfully, and check Logs for recent runs.
  • Webhook validation fails in Zoom. Save the trigger in Arena with the Secret Token first, then click Validate in Zoom. The workflow must be deployed for the endpoint to respond.

FAQ

A Zoom account that can authorize Marketplace apps is required. Some APIs (cloud recordings, past participants) also require the matching Zoom plan features to be enabled on that account. Arena itself needs a workspace you can edit.

Arena stores encrypted OAuth tokens for the connection, workflow configuration you create, and execution logs of runs. Arena does not keep a copy of your Zoom account. Tokens and Zoom API data are deleted within 7 days of disconnect. Full retention schedule: https://www.thearena.ai/privacy#data-retention

Yes. Connect each account separately under Integrations and pick the right connection on each Zoom block.

Arena does not send Zoom-app activation emails. Product and account email follows your Arena notification preferences. To stop product email, update those preferences in your Arena account or contact us.

Open the Zoom connection under Integrations and use Reconnect to re-authorize. Workflows keep using the same connection. Removing the app in Zoom or Disconnect in Arena deletes the tokens and those workflows will fail until you add the app again.

No. The Marketplace app is a user OAuth connection. Server-to-Server OAuth is an admin-created Zoom app whose credentials you paste into Arena. Use it for production workflows that should not depend on a person's login.

OAuth tokens are encrypted at rest and never shown in the editor or logs. Zoom webhooks are verified with HMAC-SHA256 and a five-minute timestamp window. Disconnect or uninstall deletes the tokens. Details: https://www.thearena.ai/security/zoom

Contact support

If you get stuck adding, using, or removing the Arena Zoom app, use the contact form and include your workspace name, the Zoom user email you connected, and a description of the error. We typically respond within one business day.

Related: Privacy Policy · Terms of Service · Security