Zoom (User OAuth)
User-managed Zoom OAuth app — no admin role or paid plan needed.
Fields
| Field | Description | Required |
|---|---|---|
| Client ID | Generated when you create a General App (user-managed) in the Zoom App Marketplace under the meeting host's Zoom account. | Yes |
| Client Secret | Generated alongside the Client ID. After saving, click "Connect Zoom account" so the host can authorize the app. | Yes |
When to use this instead of Server-to-Server
The Server-to-Server credential is simpler to run but requires a paid Zoom plan and an account admin to create the app. This user-managed OAuth credential removes both requirements: any regular user on the Zoom account can create the app, free plans included. In exchange, the meeting host has to click through a one-time authorization, and the credential acts as that one user.
Setup Steps
- Step 1: Sign in to the Zoom App Marketplace as a user on the Zoom account the meeting host belongs to, and choose Develop → Build App → General App. Keep the default User-managed setting.
- Step 2: Under OAuth Redirect URL, enter
https://www.falconbuilder.dev/api/auth/zoom/callback. - Step 3: Under Scopes, add the user-level meeting scopes —
meeting:read:meeting,meeting:read:list_meetings,meeting:write:meeting,meeting:update:meeting, andmeeting:delete:meeting(older accounts show the classicmeeting:read/meeting:writepair instead). - Step 4: In Falcon Builder, go to Dashboard → Credentials → Add Credential, pick Zoom (User OAuth), paste the app's Client ID and Client Secret, and save.
- Step 5: Open the saved credential and click Connect Zoom account. The meeting host signs in to Zoom and clicks Allow — done.
Notes
- The credential acts as the user who authorized it — meetings are created under that host by default, so the Zoom node's Host Email field can be left empty.
- The app does not need to be published to the Zoom Marketplace: an unpublished user-managed app can be authorized by users on the same Zoom account it was created in. That's also the constraint — create it in the meeting host's account, not a personal one.
- Zoom rotates refresh tokens on every use; Falcon Builder refreshes and re-stores them automatically at execution time. If the credential ever stops working (for example, the token was revoked in Zoom), open it and click Reconnect Zoom account.