Zoom integration

Connect your Zoom account to fetch cloud recordings directly into your coaching sessions. This requires creating a free OAuth app on the Zoom Marketplace.

On Desktop Edition manually fetch recordings from the Recordings page and import them into the Platform.

Prerequisites

• A Zoom account with cloud recording enabled
• Coaching Platform Desktop Edition installed

Zoom App Marketplace

Zoom: Create general app

Zoom: Save client ID and secret

Zoom: Change app name

Platform: Copy redirect URI

Zoom: Paste into OAuth redirect URL

Zoom: Add scope: View a user

Zoom: Add scope: View a users meeting

Zoom: Add scope: List all cloud recordings

Zoom: Scopes added

Platform: Save Zoom credentials and restart app

Platform: Connect Zoom and enter credentials

Zoom: Allow permission

Zoom: Connected

Platform: Zoom connected

Platform: Recordings

Platform: Fetch recordings

Zoom: App has been added

---

Step 1: Create a Zoom OAuth app

1. Go to the Zoom App Marketplace and sign in with your Zoom account
2. Click Develop in the top menu, then Build App
3. Choose General App as the app type
4. Give your app a name (e.g. "Coaching Platform") and click Create

Step 2: Configure credentials

1. On the app page, you'll see your Client ID and Client Secret
2. Open the coaching platform and go to Settings > Zoom
3. Copy the Client ID and Client Secret into the fields in the app
4. Copy the Redirect URI shown in the app: http://localhost:19170/api/zoom/auth/callback
5. Back in the Zoom Marketplace, paste this Redirect URI into the OAuth Redirect URL field

Step 3: Add required scopes

Under Scopes in the Zoom Marketplace, add the following:

Scope	Purpose
user:read:user	Read your Zoom profile
meeting:read:list_meetings	List your meetings
cloud_recording:read:list_user_recordings	Access your cloud recordings

tip

If you cannot find these exact scope names, search for "user read", "meeting read", and "cloud recording read" in the scope search box. Zoom periodically updates scope naming conventions. Use the closest matching read-only scopes for user, meetings, and recordings.

Step 4: Save and connect

1. Click Save in the Zoom Marketplace
2. Back in the coaching platform, click Save credentials
3. Click Connect Zoom. Your default browser will open to authorise the connection
4. After authorising, you'll see a success page in the browser. Return to the app.
5. The Zoom connection card should now show "Connected as your@email.com"

Using Zoom recordings

Once connected:

1. Go to Recordings in the sidebar
2. Select a month and click Fetch Recordings
3. Your Zoom cloud recordings will appear with video, audio, and transcript files
4. Click the import button on any recording to link it to a coaching session

Troubleshooting

"Invalid redirect URL" error

Ensure the Redirect URI in the Zoom Marketplace exactly matches the one shown in the coaching platform settings > Zoom. The URL includes a port number (e.g. http://localhost:19170/api/zoom/auth/callback).

Connection expires

Zoom tokens expire periodically. If you see connection errors, go to Settings > Zoom and click Reconnect.

Scopes not found

Zoom has migrated to granular scopes. If the exact scope names listed above don't appear, search for the closest read-only equivalents. The app needs permission to read your user profile, list meetings, and access cloud recordings.