Zoom
Last updated
Was this helpful?
Last updated
Was this helpful?
DitCal integrates with Zoom to automate the scheduling and management of virtual meetings. Once your Zoom account is connected, DitCal can create, update, and delete Zoom meetings based on your booking activity. Zoom links are embedded in confirmation and reminder emails, creating a seamless experience for your clients.
meeting:read:list_meetings
To list all meetings scheduled via DitCal
Used to verify whether a meeting already exists or to fetch scheduled meetings
meeting:read:meeting
To retrieve specific Zoom meeting details
Used when displaying meeting info in the booking details
meeting:read:invitation
To fetch the invitation content (used in confirmation emails)
Called after a meeting is created to get the join link and details
meeting:write:meeting
To create or update Zoom meetings
Called when a new booking is made or rescheduled
meeting:delete:meeting
To delete Zoom meetings
Called when a booking is canceled
user:read:email
To fetch the authenticated user’s email address
Used during integration to validate Zoom account ownership
user:read:user
To get user details like timezone, name, ID
Used to personalize meeting settings like timezone
Follow these steps to connect your Zoom account to DitCal:
Log in to your DitCal account.
Go to the Settings section.
Click on Apps.
In the Apps tab, locate Zoom.
Click Connect and sign in with your Zoom account.
Grant DitCal the necessary permissions to create and manage meetings.
Confirm and save the integration.
If you no longer want to use Zoom with DitCal, you can easily disconnect the integration from your DitCal account.
Log in to your DitCal account.
Go to Settings → Apps.
Locate Zoom under the list of connected apps.
Click Delete button next to Zoom.
Confirm the action when prompted.
Once disconnected:
DitCal will no longer create or manage Zoom meetings on your behalf.
Existing bookings in DitCal will retain the Zoom link (if already created), but no further Zoom actions will be performed.
You can reconnect Zoom at any time by repeating the connection steps.
To meet Zoom's requirements, here’s a scope-by-scope testing guide:
meeting:read:list_meetingsAction: After connecting your Zoom account, go to the Bookings section in DitCal and select a Zoom-based event.
Test Instruction:
The app checks Zoom to see if a meeting already exists for the event time.
Log in to your Zoom account, go to Meetings → Upcoming and verify that DitCal displays a match.
meeting:read:meetingAction: Click on any Zoom event in DitCal's booking dashboard.
Test Instruction:
DitCal retrieves full meeting details.
Confirm these values match what’s shown on your Zoom dashboard.
meeting:read:invitationAction: Book a test meeting in DitCal using an event type with Zoom as the location.
Test Instruction:
After booking, check the confirmation email sent to the invitee.
It should include the full Zoom invitation body fetched from Zoom’s API.
meeting:write:meetingAction: Book a new event in DitCal using an event type configured with Zoom as the location.
Test Instruction:
A new meeting is created in Zoom.
Verify it appears under Meetings → Upcoming in your Zoom dashboard.
meeting:write:meeting (update)Action: Reschedule the test booking created earlier.
Test Instruction:
DitCal deletes the old meeting and creates a new one with updated date/time.
Confirm the new meeting appears in Zoom and the updated link is included in the updated confirmation email.
meeting:delete:meetingAction: Cancel the DitCal booking from the dashboard.
Test Instruction:
DitCal sends a delete request to Zoom.
Verify that the corresponding meeting is removed from your Zoom account under Meetings → Upcoming.
user:read:email and user:read:userAction: During the Zoom integration flow in DitCal.
Test Instruction:
After connecting Zoom, DitCal fetches your email and profile info to verify account identity and apply default meeting settings like timezone.
You can verify this in DitCal under Settings → Apps → Zoom, where your connected Zoom email is shown.
Disconnect Zoom: Go to Settings → Apps → Zoom → Disconnect.
Refresh Integration: Disconnect and reconnect Zoom to refresh tokens or permissions.
Edit Preferences: You can customize Zoom meeting defaults in Settings → Apps → Zoom.
Zoom Meetings Not Being Created?
Ensure Zoom is selected in the event type configuration.
Recheck your Zoom permissions in DitCal → Apps.
Ensure your Zoom account is a licensed or pro account (free Zoom accounts may have API limits).
Disconnect and reconnect the integration.
DitCal’s Zoom integration automates meeting creation, updates, and cancellations while ensuring your clients receive accurate join links. The integration uses all requested Zoom API scopes as outlined above, and you can test each scope through simple, clear in-app actions.
By following the steps in this guide, you and the Zoom App Review Team can fully validate that each scope is being appropriately used within DitCal.
Integrating Zoom with DitCal helps streamline your virtual meeting scheduling, ensuring an efficient and professional experience for both you and your clients. Follow the steps above to set up the integration and optimize your meeting management with DitCal.
