Connecting Zoom
Koalafied can read your Zoom meetings and cloud recordings so you can match them to sessions and keep Evidence on your devices.
Before you start
- A Zoom account with cloud recording available if you want recordings.
- Koalafied installed on iPhone, iPad, or Mac.
- For Zoom to stay signed in across your Apple devices, turn on iCloud Keychain (Settings → Apple ID → iCloud → Passwords & Keychain). This is separate from Koalafied’s CloudKit sync.
Connect
- Open Settings → Connections.
- Tap Connect Zoom.
- Sign in to Zoom in the system browser sheet and allow access.
- When Zoom finishes, return to Koalafied. The Connections screen shows your Zoom email and the scopes granted.
On Mac, sign-in happens in a Koalafied window and won't reuse your browser's Zoom session.
You only need to complete this once per Apple ID when iCloud Keychain is on. Other devices pick up the connection after Keychain syncs (often within a minute; pull Connections to the foreground if it still shows disconnected).
Scopes we request
Koalafied asks for read-only access:
| Scope | Why |
|---|---|
user:read:user | Show which Zoom account is connected |
meeting:read:list_meetings | List past and upcoming meetings for matching and booked hours |
cloud_recording:read:list_user_recordings | List cloud recordings by month |
cloud_recording:read:list_recording_files | Download a meeting’s video, audio, and transcript files |
We do not request write scopes, admin scopes, or participant-list scopes.
Managed Zoom accounts (admin pre-approval)
Some workplaces require a Zoom Marketplace administrator to approve apps before staff can connect them. If Zoom shows a pre-approval or admin message instead of the allow screen:
- Ask your Zoom admin to approve Koalafied for your account or organisation.
- Try Connect Zoom again after they approve it.
Disconnect
Disconnect on any device:
- Asks Zoom to revoke the token when possible (best effort).
- Always deletes Koalafied’s Zoom credentials from the Keychain item reserved for this app.
- With iCloud Keychain on, that deletion syncs so your other Apple devices sign out of Zoom in Koalafied too.
Disconnect does not delete meetings, recordings, or Evidence already stored in Koalafied.
Privacy
Zoom credentials stay in your Apple Keychain (synchronised via iCloud Keychain when enabled). They are never stored in CloudKit or in export files. The Public Client ID used for OAuth is not a secret; Koalafied never ships a Zoom client secret.