Built LMS Help Center
Settings

Configure SCIM Provisioning

Sync users, groups, and profile attributes from an identity provider.

Use SCIM when your identity provider should automatically create, update, or deactivate users.

Before you begin

You need:

  • Admin access to authentication settings.
  • Identity provider admin access.
  • Agreement that the IdP owns user lifecycle or group membership.
  • A secure place to store the SCIM token.
  • A pilot user or group for testing.

Manual changes to synced fields or groups can be overwritten by the source system.

Enable SCIM

  1. Open Authentication > SCIM.
  2. Turn on Enable SCIM Provisioning.
  3. Generate or copy the SCIM token if a token is not already available.
  4. Copy the SCIM Base URL.
  5. Add the base URL and token to your identity provider.
  6. Add attribute mappings.
  7. Decide whether to sync groups.
  8. Save settings.

SCIM tokens are sensitive. Store the token in the identity provider or your approved secrets manager. If a token is exposed, rotate it.

Map attributes and groups

Map required identity attributes first:

User dataTypical SCIM source
EmailuserName or emails[type eq "work"].value
First namename.givenName
Last namename.familyName
Display namedisplayName

Map organization custom fields only when the source system is truly the owner of that data.

Turn on group sync when your identity provider should create groups and manage membership. Make group and membership changes in the identity provider when it owns the group.

Verify success

SCIM is working when:

  • The IdP accepts the SCIM Base URL and token.
  • A pilot user is created or updated in Built LMS.
  • Group membership appears as expected.
  • Deactivation behavior matches your access policy.
  • Synced profile fields match the source system.

Troubleshooting

On this page