Zoom Integration Documentation

Overview

The CandidateSeekers Zoom integration enables scheduled interviews, automated meeting creation, and webhook-based updates when interviews start, end, or change. The integration follows strict least-privilege access and privacy-first data handling principles.

OAuth Configuration

OAuth Redirect URL

Deauthorization Endpoint

Webhook Event URL

Required Scopes

CandidateSeekers requests the minimal set of permissions needed for interview scheduling:

Meetings

• meeting:write:meeting — Create and schedule interviews
• meeting:read:meeting — Read meeting details
• meeting:read:participant — Track attendance

Recording

• cloud_recording:read:recording — Metadata only

User

• user:read:user — Read user profile

Explicitly NOT Requested

• No update permissions
• No delete permissions
• No recording write access
• No user write access

This scope set reflects Zoom’s least-privilege and data-minimization guidelines.

Event Types Supported

CandidateSeekers does not update or delete Zoom meetings via API. All schedule changes and deletions are detected exclusively via Zoom webhook events and synchronized internally.

Meeting Events

• meeting.created — Creates interview records
• meeting.started — Updates interview status
• meeting.ended — Marks interviews as completed
• meeting.updated — Syncs schedule changes
• meeting.deleted — Cleans up interview data

Attendance Events

• meeting.participant_joined — Tracks participant presence
• meeting.participant_left — Supports attendance and no-show indicators

Recording Events

• recording.completed — Detects recording availability
• recording.transcript_completed — Detects transcript availability metadata (when enabled by the host)

Data Usage & Storage

Zoom data is accessed exclusively to automate interview workflows. All data is encrypted in transit and at rest.

We Do NOT Store

• Audio files
• Video files
• Chat contents
• Transcript content

Stored Data Includes

• Meeting IDs and timestamps
• Participant join/leave indicators
• Recording and transcript availability metadata

Prerequisites

• A verified Zoom business account
• Administrator permissions in CandidateSeekers
• Your Zoom Developer App Client ID and Secret