How to Connect Zoom and Zoom Phone

Updated:


July 2, 2026

This guide walks you through creating a Zoom OAuth app, configuring the right permissions, and connecting your Zoom account. You will need a Zoom account with admin access for some features (user directory, call logs, and recordings).


What you need

  • A Zoom Marketplace developer account
  • Zoom account admin access (required for directory, group, and Zoom Phone admin scopes)
  • A Zoom Phone license if you plan to use the Zoom Phone integration
  • Your Unified workspace (to store credentials and start the connection)

Note: Zoom and Zoom Phone are separate integrations in Unified. You can use one OAuth app for both, as long as that app includes the scopes for every feature you need.


Step 1: Create a Zoom OAuth app

  1. Sign in to the Zoom App Marketplace.
  2. Go to Develop → Build App.
  3. Choose General App and click Create.
  4. Enter an app name and basic details.

On the Basic Information page:

  1. Open App Credentials and note your Development Client ID and Client Secret.
    • Use development credentials while the app is still in testing.
    • After the app is published, switch to Production credentials.
  2. Under OAuth Information, configure:
    • OAuth Redirect URL — use the exact URL for your Unified region (see below).
    • OAuth Allow List — add the same URL (or the base domain if Zoom accepts it).
  3. If Strict Mode URL is enabled, the redirect URL must match character-for-character.

OAuth redirect URL by region

Add the redirect URL that matches where your Unified workspace is hosted:

RegionRedirect URL
UShttps://api.unified.to/oauth/code
EUhttps://api-eu.unified.to/oauth/code
AUhttps://api-au.unified.to/oauth/code

Important: Copy the URL exactly. A trailing slash, wrong subdomain, or http instead of https will cause the connection to fail.


Step 2: Add the required scopes (permissions)

In your Zoom app, open the Scopes page and add the permissions below. Only add scopes for the features you actually use.

For each scope, Zoom may ask you to describe why your app needs it. Keep the explanation tied to your use case (e.g. 'Read call history for CRM logging' or 'List meetings for calendar sync').

Required for sign-in (Zoom and Zoom Phone)

Add these for any connection:

  • user_profile
  • user_info:read
  • user:read

Zoom — users and groups

If you sync users or groups:

FeatureScopes to add
Read usersuser:read:user:admin, user:read:list_users:admin
Write usersuser:write:admin
Read groupsgroup:read:admin, group:read:list_groups:admin
Write groupsgroup:write:admin

Zoom — meetings and webinars

If you work with meetings or webinars:

FeatureScopes to add
Read meetingsmeeting:read:list_meetings
Create / update / delete meetingsmeeting:write:meeting, meeting:update:meeting, meeting:delete:meeting
Read webinarswebinar:read:list_webinars
Manage webinarswebinar:write:webinar, webinar:update:webinar, webinar:delete:webinar, webinar:write:registrant, webinar:update:registrant, webinar:delete:registrant, webinar:write:panelist, webinar:update:panelist, webinar:delete:panelist

Zoom Phone — calls, recordings, and users

If you use the Zoom Phone integration:

FeatureScopes to add
Read Zoom Phone usersphone:read:user:admin
Read call historyphone:read:call_log:admin
Read call recordingsphone:read:recording:admin

Note: Zoom Phone scopes require a Zoom Phone license on the account you connect.


Step 3: Add credentials in Unified

  1. In the Unified dashboard, open Integrations.
  2. Enable Zoom and/or Zoom Phone.
  3. Enter the Client ID and Client Secret from your Zoom app (development credentials while testing; production credentials after publish).
  4. Save the integration.

The Client ID and Client Secret in Unified must match the values shown in the Zoom Marketplace for the same app and environment (Development vs Production).


Step 4: Connect a Zoom account

  1. Start a new connection for Zoom or Zoom Phone (from the dashboard or your app's auth flow).
  2. You will be redirected to Zoom to sign in and approve the requested permissions.
  3. After approval, you are redirected back and the connection is created.

Tip: The Zoom user who authorizes the connection should be an account admin if you use admin-level scopes (users, groups, call logs, recordings).


Testing vs published apps

Zoom apps start in development / testing mode. This affects who can connect.

While the app is in testing

  • Only Zoom accounts added as authorized testers (or users on the same Zoom account as the app owner) can complete OAuth.
  • Use the Development Client ID and Client Secret in Unified.
  • For each customer Zoom account that needs to connect before the app is published, that account must be added as a tester in the Zoom Marketplace:
    1. Open your app in the Zoom Marketplace Developer portal.
    2. Find Add app for testing / Local Test / Authorized testers (wording may vary).
    3. Add the customer's Zoom email or account.

If a customer sees an error that the app is not authorized, they are usually not on the tester list yet.

When the app is published

  • Any Zoom customer can connect without being added as a tester.
  • Switch Unified to the Production Client ID and Client Secret from the Zoom app.
  • Existing connections may need to be re-authorized after you switch credentials or publish.

Note: Publishing goes through Zoom's review process. Zoom may require security review for certain scopes and can take several business days. Plan ahead if you need many customers to connect on a fixed timeline.


Checklist before connecting

Use this quick checklist if a connection fails:

  • Client ID and Client Secret in Unified match the Zoom app (same environment: Development or Production).
  • OAuth Redirect URL in Zoom is exactly https://api.unified.to/oauth/code (or the EU/AU URL for your region).
  • The same URL is on the OAuth Allow List.
  • All scopes your product needs are added in the Zoom app.
  • If the app is still in testing, the connecting user's Zoom account is an authorized tester.
  • The authorizing user has admin rights when using admin scopes.
  • For Zoom Phone: the account has Zoom Phone enabled.

Troubleshooting

'Invalid redirect URI' or redirect errors

The redirect URL in Zoom does not match what Unified sends. Confirm the exact URL for your region and that Strict Mode is not blocking a valid redirect.

'App not authorized' or customer cannot sign in

The app is likely still in testing and the customer's Zoom account is not an authorized tester. Add them in the Zoom Marketplace, or publish the app.

Connection works but data is missing

Usually a missing scope. Compare the scopes in your Zoom app with the tables in Step 2 and add any that apply to the features you use.

Zoom Phone returns no calls or recordings

  • Confirm phone:read:call_log:admin and/or phone:read:recording:admin are added.
  • Confirm the connected account has Zoom Phone and admin access to phone data.

After publishing, connections stopped working

Update Unified with the Production Client ID and Client Secret, then ask affected users to connect again.


Unified also supports Zoom Calendar as a separate integration with its own calendar-specific scopes. If you only need Zoom meetings, webinars, users, and Zoom Phone, follow this guide. If you need Zoom's native calendar product, enable the Zoom Calendar integration and add its scopes in the same (or a separate) Zoom OAuth app.

For Zoom developer documentation, see developers.zoom.us.

Share
All guidesAccounting Account Type Hierarchy in UnifiedAdvertising Report Metrics by IntegrationAmazon S3: Required IAM PermissionsATS to Vector DB: How to Power Talent Intelligence with Real-Time DataBuilding AI applications with Unified and LangbaseConcur & Concur (Company) — Connection GuideConfigure Greenhouse Native Candidate WebhooksConfigure Salesforce Meetings and Notes for UnifiedConnect Amazon Seller Central to Unified.toConnecting BambooHR via OAuth 2Connecting Google Workspace Integrations with a Service AccountCorrect WelcomeKit Scopes for Jungle IntegrationCreating Ads using the Unified Ads APICreating Walmart Items via UnifiedEnd-Users, Integrations, and ConnectionsEnriching Unified Objects with Custom MetadataEnterprise-managed authorization (EMA) with a static keyEnterprise-managed authorization (EMA) with a workspace secretEnterprise-managed authorization (EMA) with Microsoft Entra IDExtended observability — pushing API logs to ClickHouseExtended observability — pushing API logs to Grafana / LokiExtended Observability - Pushing API Logs to your Datadog InstanceFacebook Messenger Webhook SetupFireflies Integration GuideGetting started with WorkableHandling Delegated vs. Application Scopes in Microsoft IntegrationsHiBob & Unified: connection and time off guideHow long are logs retainedHow to access employees and usersHow to add API support for the Create Activity in CrelateHow to Associate a Connection ID with Your End-UserHow to build a Candidate Assessment product withHow to build a candidate sourcing or job board app with Unified.toHow to build a Discord support bot with Unified.to and LangbaseHow to Build a Fintech Application with Unified's Payments APIHow to Build an E-Commerce Product Integration with UnifiedHow to build an invoicing system with Unified.toHow to build Enterprise Search using RAGHow to configure Bullhorn Redirect URI for creating a connectionHow to configure webhooks in HubSpotHow to configure webhooks in Thrive LearningHow to configure webhooks in Toast for UnifiedHow to Connect Anthropic to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Cohere to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Google Gemini to Real-Time SaaS Data with Unified.to MCP ServerHow to connect HiBob (Bob) to Unified with OAuth 2.0How to Connect LLMs to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect OpenAI to Real-Time SaaS Data with Unified.to MCP ServerHow to create a Connection In Microsoft TeamsHow to create a token-based connection in HighlevelHow to Create a Unified.to Connection to HighLevelHow to Create a Xero Connection in Unified.toHow to create and configure webhooksHow to create Connection with HubspotHow to customize portal URLs for Stripe and GoCardlessHow to filter webhook eventsHow-to Get a Private Support Channel for Your Unified IntegrationHow to get help fromHow to get your 8x8 Connect API Key, Account ID and SMS Subaccount ID (optional): Step-by-step guideHow to get your ADP Workforce Now Oauth2 client ID, Oauth2 client secret, Oauth2 PEM certificate and Oauth2 private key: Step-by-step guideHow to get your Amazon S3 AWS Region, AWS S3 Key and AWS S3 Secret: Step-by-step guideHow to get your Ashby API Key: Step-by-step guideHow to get your Brex API token: Step-by-step guideHow to get your Bullhorn OAuth2 Client ID, OAuth2 Client Secret, API Username and API Password: Step-by-step guideHow to get your Ceridian Dayforce Username, Password and Client Namespace: Step-by-step guideHow to get your Crelate API key: Step-by-step guideHow to get your Dashlane API Key: Step-by-step guideHow to get your Deel Access Token: Step-by-step guideHow to get your Dialpad API Key: Step-by-step guideHow to get your Discord OAuth 2 credentials and bot tokenHow to get your ELMO client ID and client secret: Step-by-step guideHow to get your Gainsight Client ID, Client Secret and Gainsight API Domain: Step-by-step guideHow to get your Greenhouse API Key and Job board token: Step-by-step guideHow to get your Helpscout API Key: Step-by-step guideHow to get your HiBob Service User ID and Service User Token: Step-by-step guideHow to get your HighLevel API Key and Location ID: Step-by-step guideHow to get your HubSpot developer key and OAuth 2 credentials (Legacy Apps)How to get your Humaans API Key: Step-by-step guideHow to get your iCIMS API Username, API Password and Customer ID: Step-by-step guideHow to get your JobDiva Client ID, Username/email and Password: Step-by-step guideHow to get your Jobvite API Key, API Key Secret and Email: Step-by-step guideHow to get your Lever API Key: Step-by-step guideHow to get your Loxo Agency slug, API Key and Agency ID: Step-by-step guideHow to get your Microsoft Active Directory / Entra ID Client ID, Client Secret and Tenant ID: Step-by-step guideHow to get your Microsoft Azure AD OAuth 2 credentialsHow to get your OAuth 2 credentials for GmailHow to get your OAuth 2 credentials for Microsoft Dynamics 365How to get your OAuth 2 credentials in PipeDriveHow to get your OpenAI API Key: Step-by-step guideHow to get your Paycom SID/Username and Token/Password: Step-by-step guideHow to get your PCRecruiter Username, Password, Database ID, App Key and App ID: Step-by-step guideHow to get your SAP SuccessFactors (OpenID Connect) Username, Password, Client ID, Client Secret, Dependency Name, IAS Host and API URL: Step-by-step guideHow to get your SAP SuccessFactors Username, Company ID, Password and API URL: Step-by-step guideHow to get your Shopify Admin API access token and Store ID: Step-by-step guideHow to get your Wayfair Client ID, Client Secret and Vendor Encrypted Key: Step-by-step guideHow to get your Workable API Token and Subdomain: Step-by-step guideHow to get your yotpo APP Key / Store ID and Secret Key: Step-by-step guideHow to Handle Attachments in Invoice, Bill and Credit MemoHow to Manage Google Ad Manager Orders, Line Items and Creatives with theHow to migrate or import your integrations into Unified.toHow to obtain your GitHub OAuth2 credentialsHow to Power Claude with Live Customer Data Using Unified MCPHow to receive assessment orders from an ATS with Unified.toHow to register a Google developer app and get OAuth 2 credentialsHow to register a Salesforce developer app and get OAuth 2 credentialsHow to register a Slack developer account and get OAuth 2 credentialsHow to Register a Workday Developer App and Get OAUTH2 CredentialsHow to Register a Workday Developer App and Get OAUTH2/ SOAP CredentialsHow to Register a ZendeskSell Developer App and Get OAUTH2 CredentialsHow to Register a Zoho Developer App and Get OAUTH2 CredentialsHow to Register an ADP Developer App and Get OAUTH2 CredentialsHow to Register an Atlassian Developer App and Get OAUTH2 CredentialsHow to Register your Facebook OAuth2 ApplicationHow to Register your Google Ads OAuth2 ApplicationHow to Register your MetaAds OAuth2 applicationHow To Request & Write Raw Integration DataHow to Retrieve Microsoft Dynamics 365 Business Central CredentialsHow to set up a custom API URL with a CNAMEHow to Set Up a Google Meet Meeting Bot with UnifiedHow to set up a HiBob marketplace installHow to Set Up a Microsoft Teams Bot with UnifiedHow to Set Up a Microsoft Teams Meeting Bot with UnifiedHow to Set Up a Webex Meeting Bot with UnifiedHow to Set Up a Zoom Meeting Bot with UnifiedHow to set up and configure NotionHow to set up Google Business Profile API access and get OAuth 2 credentialsHow to Set Up LinkedIn Webhooks with UnifiedHow to set up native webhooks for QuickBooks Online with UnifiedHow to set up Slack webhooks using event subscriptionsHow to set up Telegram (bot) with Unified.toHow to set up your scopes in HubSpotHow to setup a Freshbooks developer appHow to setup a TikTok Shop applicationHow to Setup AWS Assume Role for AWS Secret ManagerHow to setup Oracle JD EdwardsHow to Setup Quickbooks DesktopHow to setup Sage 100 with Unified.toHow to test webhooks in the Synthetic Data (Sandbox) environmentHow to troubleshoot unhealthy connectionsHow to troubleshoot unhealthy webhooksHow to Use Decision Models with the Unified GenAI APIHow to use SCIM with the Unified APIHow to use the Passthrough APIHow to Use Unified.to's Generative AI API with OpenAI and ClaudeHow to use User Provisioning and Verification with UnifiedHow virtual webhook retry and recovery worksIntegration set-up guide for LeverManaging custom validation rules in SalesforceNetSuite Authentication Setup for UnifiedNotice of Deprecation of Fields and Objects (Nov 2025)Oracle HCM / Taleo OAuth Credentials GuideRetrieval-Augmented Generation (RAG)SalesForce (External Client Apps) on Multiple OrganizationsSAML Single-Sign-OnScaling MCP Tools with Anthropic's (& OpenAI's) Defer LoadingScaling MCP Tools with Anthropic's Programmatic Tool CallingSet Environments for your Unified.to WorkspaceSetting up a Slack Bot Connection with Unified.toSetting up OAuth 2 Credentials for Greenhouse's APIsTrello Connection Guide in UnifiedUnderstanding OAuth2 Authorization flowsUnderstanding Response Time Headers in the Unified APIUnified Assessment API: Embed Assessments Inside ATS PlatformsUnified's MCP ServerUnified MCP Server with LangChain and LangGraphUnlock real-time data with virtual webhooksUse Unified to sign in your users into your applicationVincere OAuth Setup Guide for UnifiedWhy you can't use Unified's OAuth2 credentials to authorize your end users on ProductionWorkable: Creating candidates and attaching them to jobsWorkday vs Workday Legacy — Why Unified.to Supports BothWorking with hierarchical tree data in Storage, Messaging, and KMS APIs
Are we missing anything? Let us know
Was this page helpful?