SCIM Provisioning

Last updated on November 20, 2026

SCIM provisioning pushes member changes from your identity provider to TofuPilot: add a user to a linked group in Okta and they get a TofuPilot account, remove them and their access is revoked.

SCIM is available on the Enterprise plan and runs on top of SSO: SSO handles authentication, SCIM handles lifecycle. SSO works without SCIM, but SCIM requires SSO. Configuring SCIM requires the Owner role.

What SCIM syncs

Event in your directoryEffect in TofuPilot
User created in linked groupNew member, with the Viewer role and the access for new members
User removed from groupMember removed from organization
User attributes updated (name, email)Profile updated, for accounts created by SCIM only (existing accounts keep their own profile)
User suspendedMember removed from the organization (owners excepted), re-added as Viewer with the access for new members on reactivation

SCIM creates every new member with the Viewer role. Change roles in Settings > Members afterwards. Existing TofuPilot accounts must be invited to the organization first, and they keep their current role.

Configure SCIM

Set up SSO first.

Open Settings > SCIM.

Click Configure SCIM and copy the SCIM base URL and bearer token.

In your identity provider, create a SCIM 2.0 provisioning connection for TofuPilot, then paste the base URL and bearer token.

Enable provisioning in your identity provider.

The first sync runs immediately, and subsequent syncs are incremental.

Verify the sync

Add a test user to the provisioned group: the user appears in Settings > Members within a minute with the Viewer role. Remove the test user from the group: their membership is removed within a minute.

Rotate the SCIM token

Open Settings > SCIM.

Click Edit on the SCIM Provider, then Regenerate Token.

Paste the new token into your identity provider's SCIM connection.

The old token is revoked as soon as the new one is generated.

Limitations

SCIM controls organization membership, but it does not control roles or access group membership. A new member gets the organization's access for new members, which is no access by default. For other access group assignments, use the access groups UI or the API.

The Owner role cannot be assigned via SCIM. To change the Owner, contact support@tofupilot.com.

How is this guide?

On this page