Maintain Live Learning Platform Connections
Test, reconnect, disconnect, and verify live learning platform connections after setup.
Use this guide after a provider has been connected, when event owners report session creation issues, or when credentials need to be refreshed.
Before you begin
You need settings:write permission and access to Settings > Integrations >
Live Learning Platforms.
Before changing a connection, confirm:
- Which provider is affected.
- Whether existing sessions are already scheduled on that provider.
- Whether the provider card says Connected or Reconnect Required.
- Whether event owners are blocked from creating new sessions.
Disconnecting a provider prevents new sessions from using it. Existing sessions keep their saved meeting details.
Test and reconnect platforms
Test a connection
Use Test Connection after connecting a provider or when session creation starts failing.
- Open Live Learning Platforms.
- Find a connected platform that does not show Reconnect Required.
- Select Test Connection.
Built LMS runs a lightweight health check against that platform.
Possible outcomes:
| Result | Meaning |
|---|---|
| Connection Healthy | The provider accepted the credentials. |
| Platform Not Connected | No credentials are stored for that provider. |
| Rate Limit Exceeded | The provider rejected the health check because too many API calls were made. |
| Reconnection Required | Credentials are expired or cannot be refreshed. Reconnect the provider. |
| Connection Test Failed | The provider or network returned another error. |
Built LMS also enforces a local cooldown: you can test the same platform once every 5 minutes from the page.
Reconnect a platform
Reconnect when a card shows Reconnect Required or when health checks report expired credentials.
- Open Live Learning Platforms.
- Find the affected platform.
- Select Reconnect [Platform].
- Complete the same authorization flow used for the original connection.
- Return to Built LMS and confirm the card shows Connected.
For OAuth platforms, reconnect stores fresh encrypted access and refresh token credentials. For Livestorm, reconnect by entering and saving a valid API key.
Disconnect a platform
Use Disconnect when Built LMS should stop creating new sessions on a provider.
- Open Live Learning Platforms.
- Find the provider.
- Select Disconnect.
- Confirm the dialog.
Disconnecting:
- Attempts token revocation for OAuth providers when possible.
- Deletes the stored credentials from Built LMS.
- Prevents new sessions from being created on that platform.
- Does not change existing sessions.
The confirmation dialog says Existing sessions will not be affected. This means already-created sessions keep their saved meeting details, but new sessions cannot use that provider until it is connected again.
Create a test session
After at least one healthy platform is connected:
- Open Learning > Live Learning.
- Open or create an event.
- Go to Sessions.
- Add a session.
- Select a connected platform.
- Set the scheduled start time, host, capacity, and other session details.
- Save the session.
Only healthy connected platforms appear in the platform dropdown. If a platform is disconnected, expired, or requires reconnect, it will not be available for new sessions.
Session dates must be at least 5 minutes in the future.
Verify success
Platform maintenance is complete when:
- The affected provider card shows Connected.
- Test Connection returns Connection Healthy.
- Event owners can select the provider when creating a new session.
- A test session creates a join link.
- Event owners know that disconnecting a provider prevents new sessions but does not remove existing sessions.
Troubleshooting
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.
Wait at least 5 minutes before testing the same provider again from the page. If the provider itself is rate limiting Built LMS, wait longer before retrying.
Check the provider app scopes or permissions, provider account access, and whether the provider app or API key was revoked.
Disconnecting a provider does not delete existing Built LMS sessions. Check the Live Learning event, filters, and session date range. If the provider meeting was deleted directly in the provider account, reconnect the platform and update or recreate the affected session.