Zoom Integration Guide
This guide explains how ONGEVIT program providers and administrators add, use, troubleshoot, and remove the Zoom integration.
Adding Zoom to ONGEVIT
Prerequisites for adding the app
- An ONGEVIT program provider or administrator account with permission to manage programs.
- A Zoom account permitted to add Marketplace apps.
- Zoom administrator pre-approval if your Zoom organization restricts Marketplace app installation.
Steps
- Sign in to ONGEVIT through the Zoom integration page.
- Open your profile menu, choose Settings, and select the Integrations tab.
- In the Zoom row, select Connect.
- Sign in to the Zoom account that will host your program meetings.
- Review the permissions requested by ONGEVIT and select Allow.
- Wait to be returned to ONGEVIT. The Zoom row will show that the connection is active.
If authorization does not complete, use the Troubleshooting section below.
Using the Zoom integration
Create a Zoom meeting for an event
Prerequisites: Zoom is connected; you can edit the program; and the program item is an online or hybrid event with a date, start time, duration, and time zone. A hybrid event must also have a venue.
Use case: Create a host meeting and participant join link while scheduling a live program event.
- Create or edit a program event.
- Set the event type to Online or Hybrid.
- Turn on Create Zoom meeting.
- Choose the meeting options you need, then save the event.
ONGEVIT creates the meeting in the connected host's Zoom account and saves its meeting ID, password, and join URL with the event.
Configure meeting options
Prerequisites: The event is configured to create a Zoom meeting. Local or cloud auto-recording must also be available on the connected Zoom account; cloud recording generally requires an eligible Zoom plan and Zoom administrator settings.
Use case: Control how participants enter the meeting and whether Zoom records it automatically.
- Enable or disable the waiting room.
- Allow or prevent joining before the host.
- Mute participants when they enter.
- Set initial host and participant video behavior.
- Choose no automatic recording, local recording, or cloud recording.
Remove a Zoom meeting from an event
Prerequisites: The event already has an ONGEVIT-managed Zoom meeting, the integration remains connected, and you can edit the program.
Use case: Cancel the Zoom meeting while keeping the ONGEVIT event.
- Edit the event and select Remove Zoom meeting.
- Confirm the removal.
- Save the event to remove the Zoom meeting and its managed join link.
Join a Zoom meeting
Prerequisites: The provider created a Zoom meeting for an Online event, and the participant has access to that event and its live-class content in ONGEVIT. The Zoom app or a supported web browser may be required by Zoom.
Use case: Join the scheduled live session from the same place where the participant views event details.
- Open the event in ONGEVIT.
- Select the Zoom join link in the event details.
- Follow Zoom's prompts to join in the Zoom app or browser.
This participant join-link flow is available for Online events. ONGEVIT can create a Zoom meeting for a Hybrid event, but participant event details do not currently show its Zoom join link. The provider must give Hybrid event participants the joining details separately.
Watch a Zoom cloud recording replay
Replay prerequisites: The provider selected Cloud automatic recording, the connected Zoom account supports cloud recording, Zoom has finished processing the recording, and a replay link is available on the event.
Use case: Watch a recorded live session from the participant event page after the meeting.
- Open the event in ONGEVIT after the live session.
- Find the Event Replay section.
- Select Watch Replay, or use the embedded player when one is shown.
Local recordings stay on the host's device and do not automatically appear as ONGEVIT replay links.
Removing Zoom from your account
Disconnect from ONGEVIT
- Sign in to your ONGEVIT provider or administrator account.
- Open your profile menu, choose Settings, and select the Integrations tab.
- In the Zoom row, select Disconnect.
- Wait for ONGEVIT to show Zoom as disconnected.
Remove ONGEVIT from your Zoom account
- Sign in to the Zoom App Marketplace.
- Select Manage in the upper-right corner.
- Select Added Apps in the left navigation.
- Find ONGEVIT and select Remove.
- Choose a reason if desired, then select Remove to confirm.
What removal changes
- ONGEVIT can no longer create, update, or remove meetings in the disconnected Zoom account.
- New ONGEVIT events cannot create Zoom meetings until an authorized Zoom account is reconnected.
- Review existing meetings and recordings in Zoom and delete any that you no longer need.
- Review meeting or replay links already saved on ONGEVIT events. Use the deletion-request instructions below if you want retained ONGEVIT data removed.
How we handle your data
- Disconnecting in ONGEVIT removes the active Zoom connection from your ONGEVIT settings and stops that connection from being used for new Zoom actions. Removing ONGEVIT in the Zoom App Marketplace revokes the app's authorization in Zoom.
- ONGEVIT stores meeting details and external replay links with program events. Zoom cloud recording media remains hosted and managed by Zoom.
- ONGEVIT program and event data remains subject to the ONGEVIT Privacy Policy and its normal retention and deletion process.
- To request deletion of stored Zoom connection data, including OAuth access and refresh tokens, retained event metadata, or ONGEVIT account or personal data, email info@yogaforlifejapan.com.
Troubleshooting
The app cannot be added
- Confirm that you signed in with an ONGEVIT provider or administrator account, not a participant account.
- Confirm that you are authorizing the intended Zoom account.
- Ask your Zoom administrator to pre-approve ONGEVIT if Marketplace apps are restricted.
- Allow redirects and cookies for ONGEVIT and Zoom, then try Connect again.
A meeting is not created
- Check that the Zoom row in Settings → Integrations shows an active connection.
- Confirm that the event type is Online or Hybrid and Create Zoom meeting is enabled.
- Confirm that the event has a valid date, start time, duration, and time zone before saving.
- For a Hybrid event, confirm that a venue is selected.
A recording is unavailable
- Confirm that the selected recording type is supported by the host's Zoom plan and settings.
- For cloud recordings, wait for Zoom to finish processing the recording.
- Check the recording directly in the host's Zoom account.
Still need help? Email info@yogaforlifejapan.com. Support hours and response times are listed in the ONGEVIT Help Center.