Communication & Collaboration

Zoom

Zoom: Overview and setup

Automate meeting creation, user management, and recording retrieval with the Zoom integration.

Connect Zoom to Atomicwork to automate meeting creation, manage user accounts, and retrieve recordings as part of your IT and collaboration workflows.

Use cases

By connecting Zoom, your teams can:

Automate meeting creation: Create Zoom meetings with specific topics, agendas, times, and settings as part of event or onboarding workflows. For example, a workflow can automatically schedule a Day 1 orientation meeting when a new employee is onboarded.
Manage user accounts: Create Zoom user accounts during onboarding and list users for directory management.
Handle meeting registrations: Add registrants to meetings and track registration status — useful for company-wide training sessions or town halls.
Access meeting recordings: Retrieve cloud recordings for compliance, archival, or knowledge sharing purposes.

Permissions

To connect Zoom to Atomicwork, you need:

Org admin access in Atomicwork
Admin access to your Zoom account with permission to create and manage OAuth apps

The integration authenticates via OAuth 2.0 and requests the following scopes during authorization:

OAuth Scope	Purpose
`meeting:read:list_meetings:admin`	Read access to list meetings. Required for the List meetings action to retrieve meetings for a user.
`meeting:read:meeting:admin`	Read access to meeting details. Required for meeting management and reporting operations.
`meeting:write:meeting:admin`	Write access to create and update meetings. Required for the Create meeting action as part of automated workflows.
`meeting:read:list_registrants:admin`	Read access to list meeting registrants. Required for the List meeting registrants action to track attendance and registration status.
`meeting:write:registrant:admin`	Write access to add meeting registrants. Required for the Add meeting registrants action for automated event enrollment.
`user:read:list_users:admin`	Read access to list users. Required for the List users action and directory sync.
`user:read:settings:admin`	Read access to user settings. Required for user configuration and reporting operations.
`user:write:user:admin`	Write access to create and update users. Required for the Create user action during onboarding workflows.
`cloud_recording:read:list_recording_files:admin`	Read access to cloud recordings. Required for the Get meeting recordings action for compliance and archival use cases.
`contact:read:list_contacts:admin`	Read access to contact information. Required for contact management and directory operations.

Setup

Navigate to Settings > App Store > Zoom.
Click Connect to initiate the OAuth flow.
Sign in with your Zoom admin account and authorize the requested permissions.
Once authorized, the integration is active.

Supported workflow actions

Once connected, you can automate the following Zoom actions within your Atomicwork workflows:

Action	Description
Create meeting	Create a Zoom meeting with topic, type, start time, duration, password, agenda, timezone, and meeting settings.
List users	List Zoom users with pagination and status filtering.
Create user	Create a new Zoom user with email, name, display name, password, and user type.
List meetings	List meetings for a specific user, filtered by date range and meeting type.
Add meeting registrants	Add registrants to a meeting with email, name, and optional comments.
List meeting registrants	List registrants for a meeting, filtered by registration status.
Get meeting recordings	Retrieve cloud recordings for a specific meeting.
Call API	Make a generic API call to any Zoom endpoint for custom operations.

Troubleshoot common issues

Error	Cause	Resolution
Authentication failure	The OAuth authorization code has expired or the redirect URI doesn't match.	Re-initiate the OAuth flow from Settings > App Store > Zoom.
Token refresh failure	The refresh token has expired or been revoked.	Re-authenticate the integration to generate new tokens.
API errors (5xx)	The Zoom API is experiencing issues.	Check the Zoom status page and retry the operation.