← Back to firstcall

Zoom Integration

Last updated: June 8, 2026

Overview

FirstCall provides a developer API for joining Zoom meetings programmatically as a visible bot participant. When you call our REST endpoint with a Zoom meeting URL, FirstCall spawns a bot that joins the meeting via the official Zoom Meeting SDK. The bot can capture audio in real time, generate transcription (optional), capture periodic screenshots (optional), and stream all data back to your application via WebSocket and webhooks.

The bot appears in the Zoom meeting as a named participant. Meeting hosts retain full control: they can admit, remove, or ignore the bot using standard Zoom participant controls.

How It Works

  1. Your application calls POST https://api.firstcall.dev/v1/bots with a meeting URL, bot display name, and mode
  2. FirstCall provisions a bot instance on our infrastructure
  3. The bot loads the Zoom Meeting SDK and signs a JWT using FirstCall's Zoom SDK credential
  4. The SDK joins the meeting as a visible participant under the display name you specified
  5. Meeting audio is captured in real time and streamed to your application via WebSocket
  6. Optional features (transcription, screenshot capture, chat messaging) are controlled per-bot via API flags
  7. When the meeting ends, you stop the bot via DELETE /v1/bots/{bot_id}, or the bot leaves automatically based on configured timeouts

Scopes & Permissions

FirstCall's Zoom integration does NOT request OAuth scopes. Specifically:

This architecture means there is no per-user authorization to grant or revoke. The FirstCall Zoom Marketplace listing exists to authorize FirstCall's SDK credentials to join meetings hosted by external Zoom accounts, in accordance with Zoom's SDK publication policy.

Installing the Integration

  1. Create a FirstCall account at app.firstcall.dev
  2. Generate an API key from your dashboard
  3. Top up credits or use the free-tier hours (see pricing)
  4. Call POST /v1/bots with a Zoom meeting URL — the bot joins within seconds

See the REST API reference, WebSocket API reference, and Webhook API reference for the full integration guide.

Uninstalling

If FirstCall appears in your Zoom installed-apps list at marketplace.zoom.us/user/installed, you can remove it at any time using Zoom's standard uninstall flow. Because no per-user OAuth connection is established between your Zoom account and FirstCall, removal does not affect any data on FirstCall's side — there is no per-user Zoom-FirstCall binding to sever.

To delete data stored under your FirstCall account, follow the procedures in our Privacy Policy or email hi@firstcall.dev.

Data Flow & Retention

FirstCall does not record meeting audio or video. Audio is processed in real time and streamed to your application; no audio file is stored on FirstCall's infrastructure. Optional features (transcription, screenshot capture) are forwarded to your application as events and not retained beyond active forwarding.

Bot session metadata (meeting ID, bot ID, duration, cost) is retained for 7 days for billing and operational purposes, then automatically deleted. Customer account data is encrypted at rest.

For the complete data-handling policy including sub-processor list, see our Privacy Policy.

Compliance & Notification

The FirstCall bot is a visible meeting participant. As infrastructure provider, FirstCall transmits meeting data to your application based on the configuration you set via our API. You, as the developer using FirstCall, are responsible for ensuring meeting participants are notified about the bot's presence and any transcription or screenshot capture, in accordance with applicable laws (including two-party consent jurisdictions) and Zoom's Recording Notification requirements.

Support

Questions about the Zoom integration: email hi@firstcall.dev or see our Support page.