Supported Zoom integrations
Athean has two separate Zoom connections. Connecting one doesn't enable the other.
- Zoom scheduling: Adds a Zoom meeting automatically when someone books through an Athean scheduling link, or when Chat or a connected AI assistant books a meeting for the host. A Zoom administrator prepares the app, and an Athean organization administrator connects it for the team in Org settings → Zoom scheduling. Individual hosts don't need to connect Zoom for bookings. See Connect Zoom scheduling and Scheduling links.
- Zoom Phone: Supports calling through the dialer with Zoom Phone and brings your Zoom Phone call logs into Athean. It has its own setup, which you arrange with Athean support. See Set up Zoom Phone.
Recording meetings from Meetings works with Zoom, Google Meet, Microsoft Teams, and Webex meeting links. It doesn't require either Zoom connection.
Permissions and data access
- Zoom scheduling: The Zoom app uses the account-level scopes
meeting:write:meeting:adminandmeeting:delete:meeting:admin. Athean creates a Zoom meeting for the host when someone books through their scheduling link, or when Chat or a connected AI assistant books a meeting for them. If the calendar event isn't confirmed after the Zoom meeting is created, Athean keeps the Zoom meeting because the event may still exist. Check the host's calendar, and delete the Zoom meeting in Zoom if no event was created. Athean doesn't delete Zoom meetings. Your calendar connection handles availability and invitations. - Zoom Phone: Syncs your Zoom Phone call logs so your calls appear in Athean with account and contact context. Review the permissions shown during authorization.
Data is handled in line with our Privacy Policy and Terms of Use.
Connect Zoom scheduling
Your Zoom account owner, or a Zoom administrator with permission to manage Server-to-Server OAuth apps, creates the app. An Athean organization administrator connects it. Individual hosts don't connect Zoom for bookings.
Each host must belong to the connected Zoom account, with a Zoom email that matches their Athean email. Hosts also need a connected calendar with permission to create events and an active scheduling link. See Scheduling links.
- In the Zoom App Marketplace, create a Server-to-Server OAuth app for Athean in your team's Zoom account.
- Add the account-level meeting scopes
meeting:write:meeting:adminandmeeting:delete:meeting:admin. Athean checks for both scopes before it saves the connection. - Complete the required Zoom app information and activate the app. Have its Account ID, Client ID, and Client Secret ready.
- As an Athean organization administrator, open Org settings → Zoom scheduling.
- Enter the Account ID, Client ID, and Client Secret, then select Connect Zoom. Athean checks the credentials and required scopes before saving. When the connection succeeds, the page shows Zoom is connected.
Check a test booking
Changes can take a few seconds to apply. Coordinate a test booking with a teammate, then check the calendar invitation:
- The invitation's location contains the Zoom join link, and its description contains the meeting ID and passcode.
- The intended teammate is the Zoom host.
The host's Athean booking notification email also includes the join link.
Zoom scheduling applies to new bookings. It doesn't add Zoom links to existing calendar events. Connecting Zoom Phone doesn't enable Zoom scheduling. If the app type or scopes aren't available in Zoom, ask your Zoom account owner to check your Zoom permissions.
Set up Zoom Phone
You need an active Athean account (see User provisioning and licensing) and the Zoom work account intended for this connection. Your organization administrator and Athean support help prepare the setup and provide the authorization link.
- Email support@athean.com with your organization name and the work email addresses of the teammates to enable. We work with your team to confirm the setup and next steps.
- Sign in to Athean, open the authorization link supplied for your organization, and sign in with the intended Zoom work account.
- Review the requested permissions. Complete any app approval process Zoom presents, then authorize the connection.
- Wait for Athean to show Connection successful. You may safely close this page. If it shows an error, send that message to support before continuing.
Check calling after connecting
Open Settings → Calls, set Call mode to Zoom Phone, and save. During your next planned call, use Open Zoom Phone for the call controls, then check that the call activity appears in Athean. See Dialer and call settings.
Manage or disconnect Zoom
Replace or disconnect Zoom scheduling
As an organization administrator, open Org settings → Zoom scheduling.
- Replace credentials: Select Replace credentials, enter the replacement app's Account ID, Client ID, and Client Secret, and select Save new credentials. The current connection stays active until the new credentials are verified and saved.
- Disconnect: Select Disconnect and confirm. Future bookings no longer get Zoom links. Existing Zoom meetings and calendar invitations stay unchanged.
Change Zoom Phone
Contact your organization administrator or email support@athean.com. Include the affected work email addresses and whether the change is for one person or the whole team.
Data removal requests
To request permanent removal of Zoom data from Athean, contact your organization administrator or email support@athean.com.
Troubleshooting
- A booking has no Zoom link: A booking can succeed without a Zoom link, so check the actual calendar invitation. Check that the host belongs to the connected Zoom account and that their Zoom email matches their Athean email. In Zoom, check that the app is active and still has both meeting scopes. Then confirm the saved connection in Org settings → Zoom scheduling, and replace the credentials if needed.
- No authorization link, Zoom app approval required, or an authorization error: For Zoom Phone, email support@athean.com with your organization name, work email, and the message shown.
- Zoom Phone calls missing after connecting: Check that Call mode is set to Zoom Phone in Settings → Calls. If calls are still missing, email support@athean.com with one example call, its time, and what you expected to see. A successful authorization confirms the account connection, so check a real call separately.