Connect Zoom
Link your Zoom account once so the admin tool can create meeting rooms for scheduled classes up to 40 minutes.
# Why connect Zoom?
One-time setup that enables automatic meeting links for short scheduled classes.
- Connect your own Zoom Basic account from My Profile.
- After connecting, classes up to 40 minutes receive a Zoom meeting link automatically when you schedule them.
- Scheduling classes up to 40 minutes requires a connected Zoom account.
# Before you start
You need a Zoom account you can sign into.
- Use your own Zoom account (Basic is fine).
- Sign in with the same email you use for Zoom.
# Connect your account
Authorize the admin tool from your profile page.
- Open My Profile from the dashboard or navigation.
- Scroll to Integrations and click Connect Zoom.
- Sign in to Zoom if prompted and approve access.
- Return to the profile page and confirm the Zoom badge shows Connected.
# Schedule a class with Zoom
Automatic meeting links appear on class cards for classes up to 40 minutes.
- Open Class Schedule and add a class as usual.
- For classes up to 40 minutes, a Zoom button appears on the class card after scheduling.
- Click the Zoom button to open meeting details, then use Open to launch Zoom or Copy to share the link and passcode with your student.
# 40-minute limit
Zoom Basic accounts limit hosted meetings to 40 minutes.
- If your class is longer than 40 minutes, the schedule form shows a warning.
- No automatic Zoom room is created for those classes.
- Create your Zoom meeting manually in Zoom and share the link with your student.
# Disconnect or reconnect
Manage your Zoom connection from My Profile.
- Click Disconnect Zoom in Integrations if you need to remove access.
- Scheduling classes up to 40 minutes is blocked until you reconnect.
- Reconnect if you switch Zoom accounts.
# Troubleshooting
Common issues when connecting or scheduling with Zoom.
- If Connect Zoom is missing, ask your administrator to configure Zoom for the system.
- If scheduling fails, confirm Zoom shows Connected on your profile.
- If connection fails for your Zoom account but works for the administrator, the Zoom app may still be in development-only mode — your administrator must use Production credentials and request Beta Test sharing or publish the app.
- If Zoom is down, try again later or schedule a class longer than 40 minutes without an automatic room.
# Administrator: Zoom Marketplace setup
Required so teachers on their own Zoom accounts can connect (not only the developer account).
- In Zoom Marketplace, open the app under the Production tab (not Development).
- Set OAuth redirect URL and allow list to your callback URL, e.g. https://your-domain/zion-english-admin/profile/zoom/callback.
- Set Support URL to your public support page, e.g. https://your-domain/zion-english-admin/support.
- Set Documentation URL to this page, e.g. https://your-domain/zion-english-admin/docs/connect-zoom.
- Enable only these scopes: user:read:user, meeting:write:meeting, meeting:update:meeting, meeting:delete:meeting.
- Copy Production Client ID and Secret into server ZOOM_CLIENT_ID and ZOOM_CLIENT_SECRET; set ZOOM_REDIRECT_URI to the same callback URL.
- Copy the authorization URL from Marketplace (Local Test or Beta Test) into server ZOOM_AUTHORIZE_URL — Connect Zoom uses this URL.
- Under Beta Test, complete requirements and submit Request to Share so external Zoom accounts can authorize (or publish the app for full production).