Academy LMS 4.0 IS LIVE

00
Days
:
00
Hours
:
00
Minute
:
00
Second

Zoom Integration

Connecting Zoom lets Academy LMS create Zoom meetings for you and show them inside your courses. You build one app in the Zoom App Marketplace, paste three credentials into Academy, and after that every live class you schedule gets its own Zoom link, meeting ID and password automatically.

Note: Zoom is one of the two providers in the Pro Meeting addon. You need Academy LMS (free) and Academy LMS Pro active, the Meeting addon on, and a Zoom account that can create apps.

Before you start

The Meeting addon is on. See the Meeting addon guide if it is not.
You can sign in to the Zoom App Marketplace with the Zoom account that should own the meetings.
You know which Meeting API Mode your site uses. On Individual, the default, the credentials you save belong to your own account. On Globally they are shared site wide and only an administrator can save them.

Academy needs a Server to Server OAuth app. Zoom retired the older JWT app type, so a JWT app will not connect.

Step 1: Turn on the Meeting addon

Go to Academy LMS → Add-ons, search for Meeting, and switch the toggle on. Zoom is not a separate addon, it is a provider inside this one.

turn-on-the-meeting-addon

Step 2: Open the Zoom setup

Go to Academy LMS → Meeting and click Add New Meeting. Academy shows the two providers it supports. On the Zoom card, click Setup API.

Leave this dialog open. You will come back to it in Step 8 with three values from Zoom.

choose-a-provider

Part 1: Build the app in Zoom

The next six steps happen in the Zoom App Marketplace, in a separate tab. Zoom adjusts this interface from time to time, so a button may sit somewhere slightly different from the picture.

Step 3: Sign in to the App Marketplace

Open the Zoom App Marketplace and sign in with the account that should own the meetings. Every meeting Academy creates will belong to this account.

Sign in to the App Marketplace

Step 4: Start a new app

Open the Develop menu and choose Build App, or open Manage to see apps you already have.

Start a new app

Choose the Server to Server OAuth app type. This is the type Academy supports. Do not pick a JWT app.

start-a-new-app

Step 5: Name the app

Give the app a name. Only you see it, so something like your site name works well.

name-the-app

Step 6: Fill in the app information

Zoom asks for basic company and contact details before it will let you activate the app.

Fill in the app information

Complete the basic information, including a contact name and email.

Fill in the app information

Step 7: Copy the credentials

Open the App Credentials page. It shows the three values Academy needs: Account ID, Client ID and Client Secret, each with a Copy button.

 Copy the credentials

Keep this tab open, or paste the three values somewhere safe for a moment. Treat the client secret like a password.

 Copy the credentials

Step 8: Add the scopes and activate

Open the Scopes section of the app.

add-the-scopes-and-activate

Click Add Scopes.

add-the-scopes-and-activate

Search for the meeting scopes and tick the ones that let the app create and read meetings, then confirm. Without these Zoom will authenticate but refuse to make meetings.

add-the-scopes-and-activate

Finally open Activation and activate the app. An app that is not activated will not issue tokens.

add-the-scopes-and-activate

Part 2: Finish in Academy

Step 9: Paste the credentials

Back in the Zoom Setup dialog, fill the three fields in order:

1.Account ID
2.Client ID
3.Client Secret
4.Click Save & Check Connection.

Academy asks Zoom for an access token before it saves anything, so a mistake in any of the three is reported at once rather than surfacing later when you try to schedule a class.

paste-the-credentials

After it connects

Go back to Academy LMS → Meeting and click Add New Meeting. Zoom no longer asks for setup, and you get the meeting form instead. Fill in the title, the start time and the duration, and Academy creates the meeting in Zoom and stores what comes back.

The meeting then appears on the Meeting screen with its Meeting Token and Password filled in from Zoom. Add it to a course from the course Builder, and enrolled students join from the curriculum.

Migrating from a JWT app

If your site was connected with the old JWT credentials, that app type is no longer supported and the connection will fail. Build a Server to Server OAuth app as in Part 1 and save its three credentials over the old ones. Meetings you already created keep their links, since those are stored on the meeting itself.

Troubleshooting

Account ID, Client ID and Client Secret is required.

One of the three fields was left empty. All three are needed.

Saving fails even though the values look right.

Academy checks the credentials with Zoom before saving, so this is Zoom refusing them. Confirm the app is a Server to Server OAuth app, that it is activated as in Step 8, and that all three values came from the same app.

Zoom connects but meetings are not created.

The app is missing its meeting scopes. Go back to Step 8 and add them.

An instructor cannot use the credentials you saved.

On Individual mode every user connects their own Zoom account. Switch Meeting API Mode to Globally in Settings → Pages → Dashboard Page if everyone should share one account.