When you connect your academy to Single Sign-On (SSO), you can add a layer in that workflow to automatically enrolling learners into groups. This means learners will see the right content as soon as they log in, without an admin having to manage group enrollment manually.
What are the benefits?! 📈
-
Save admin time: No more manual group assignments each time a new learner joins.
-
Personalized experience: Learners land directly in the content that’s relevant to them.
-
Scalable growth: As your audience expands, automation ensures consistency and accuracy.
How does this work? 🤔
SSO tokens can carry information (attributes/claims) about each learner, such as department, role, or region. When those attributes are mapped to groups in your academy → The system reads the group information from the token → the learner is automatically placed into the matching group(s).
For example: if the SSO token includes "groups": ["Onboarding-Cohort-2025"], the learner will be enrolled into the “Onboarding Cohort 2025” group right away.
Important note: This logic only applies when a new learner account is created through SSO. Updating an existing learner’s SSO token will not retroactively adjust their group memberships.
What do I need to build this? 🛠
This setup requires a quick collaboration with your technical/SSO team. Share these steps with them:
-
Add a claim/attribute in your SSO token that lists the learner’s group(s).
-
Map that claim to groups inside your academy’s SSO configuration.
-
Test by logging in with a sample user and confirm they land in the correct group.
Next Steps 👣
-
Review the OAuth 2.0 Integration Guide (documentation also exists for other SSO protocols like SAML).
-
Identify which attribute in your IdP (Identity Provider) should represent group membership.
-
Work with your technical team to configure and test the mapping.