Provision members from your directory (SCIM)
Let your identity provider add, update, suspend and remove members, and give roles from its groups.
With provisioning, your identity provider manages who is in your organisation, so access follows your directory. It works with Microsoft Entra ID, Okta and any provider that supports SCIM 2.0. Set it up under Organisation settings › Provisioning; the tab appears when your plan includes it.
Before you start
Your organisation needs its email domains, because only people at those domains can be added. Add them on the Organisation tab. On a hosted portal the operators set them: ask them.
Connect your identity provider
- Go to Organisation settings › Provisioning.
- Copy the SCIM address.
- Choose Create SCIM token and copy the token. It isn't shown again.
- In your identity provider, add the portal as an app with SCIM provisioning:
- Microsoft Entra ID: set the Tenant URL to the SCIM address and the Secret token to the token, then test the connection.
- Okta: in the app your company sign-in uses, turn on SCIM provisioning. Set the connector base URL to the SCIM address, the unique identifier to
userName, and HTTP header authentication with the token. Turn on pushing new users, profile updates and groups.
- Assign the people and groups who should have the design language.
What happens
- Assigned: the person joins as a viewer, or with your join role if you set one, unless the provider sends a role. They sign in with company sign-in, or set a password with Forgot your password?.
- Pushed groups: they give roles through Roles from groups, matched by group name, and change as soon as membership changes.
- Switched off: the person is suspended. Their sessions in your organisation end and their access tokens stop. Their role is kept for when they're switched back on.
- Unassigned or deleted: they're removed from your organisation. Their account stays, since it may belong to other organisations.
While provisioning is on, signing in doesn't add anyone to your organisation by itself: your identity provider does. Invitations still work for guests. Members it manages show from your directory on the Members tab. Every change it makes is in the audit log as scim.*.
Change the token
- Choose Create a second token.
- Give it to your identity provider.
- Revoke the old one.
Two tokens can be active at once, so nothing stops in between.
If something goes wrong
| What you see | What to do |
|---|---|
| Create SCIM token is unavailable | Add your email domains first. |
| Someone isn't added | Check their address is at one of your domains and that they're assigned to the app. |
| Changes stop arriving | Check the token in your identity provider wasn't revoked. People already added keep their access. |