Live Learning Platform Setup
Choose the right guide for connecting, testing, and maintaining live learning video platforms.
Use Live Learning Platforms to connect the video provider Built LMS uses when admins create live learning sessions.
Built LMS supports:
- Zoom.
- Google Meet.
- Microsoft Teams.
- Livestorm.
After a platform is connected and healthy, it appears in the platform selector when admins create or edit live learning sessions. If no healthy platform is connected, session creation is blocked and Built LMS shows a message telling the admin to connect a platform first.
Before you begin
You need settings:write permission to manage platform connections. If you do
not have access, the page shows Access Restricted and tells you to contact
an organization administrator.
Before connecting a platform, confirm:
- Live Learning is enabled for the organization.
- You are signed into the correct Built LMS organization.
- You have admin access in the provider account you want to connect.
- The provider app, OAuth client, or API key is created before you start.
- The redirect URI in the provider exactly matches the Built LMS OAuth callback for that platform.
Open and review platform status
- Open Admin Dashboard.
- Go to Settings > Integrations.
- Open Live Learning Platforms.
The page shows one card per platform. Each card can show:
| State | What it means |
|---|---|
| Not Connected | No credentials are stored for this platform. |
| Connected | Credentials exist and are not expired. |
| Reconnect Required | Credentials exist, but the token is expired or unhealthy. |
Connected OAuth platforms also show the connection date and a note that tokens refresh automatically. Livestorm does not show token refresh messaging because it uses an API key.
Choose the right guide
| Goal | Use this guide |
|---|---|
| Connect Zoom, Google Meet, Microsoft Teams, or Livestorm for the first time. | Connect a Live Learning Platform |
| Test a connected platform, reconnect expired credentials, or disconnect a provider. | Maintain Live Learning Platform Connections |
| Create and manage live learning events and sessions after a platform is connected. | Live Learning |
| Configure live learning feature settings. | Live Learning Settings |
How connection setup works
OAuth platforms use a provider callback:
| Platform | Redirect URI path |
|---|---|
| Zoom | /api/auth/oauth/zoom/callback |
| Google Meet | /api/auth/oauth/google-meet/callback |
| Microsoft Teams | /api/auth/oauth/teams/callback |
For private or self-hosted deployments, the OAuth callback uses the configured canonical auth domain. Production Built LMS environments typically use:
https://auth.builtlms.comExample production Zoom redirect URI:
https://auth.builtlms.com/api/auth/oauth/zoom/callbackLivestorm does not use this OAuth redirect flow in Built LMS. It uses an API key.
Verify success
Live learning platform setup is ready when:
- Each required provider card shows Connected.
- Test Connection passes for each provider.
- Redirect URIs in provider apps match the current Built LMS environment.
- Provider scopes or permissions include meeting creation and attendance or recording access where needed.
- At least one test session can be created from a Live Learning event.
- The generated join link opens for a test learner or host.
Troubleshooting
Check that your role has settings:write, you are signed into the correct
organization, and Live Learning is enabled.
Use the provider your organization expects event owners and learners to use. Zoom, Google Meet, and Microsoft Teams use OAuth setup. Livestorm uses an API key.
Open Live Learning Platforms and test the connection. The session form shows only healthy connected platforms. If the card shows Reconnect Required, reconnect before creating sessions.