Skip to main content

SCIM Provisioning

Keep your Tomba workspace in step with your identity provider, so members are created, updated and deactivated automatically.

Written by Tomba.io Team

SCIM is a standard way to sync member accounts between services. It keeps your Tomba workspace in step with your identity provider, the service your company uses to manage logins. When you add, change or deactivate someone there, Tomba follows, so nobody has to do it by hand.

Before you start

  • A Tomba Enterprise plan.

  • The Owner or Admin role in your workspace.

  • Admin access to your identity provider. If you don't have it, ask your IT team.

  • An identity provider that works with Tomba SCIM: Okta, Microsoft Entra ID, OneLogin or JumpCloud.

Google Workspace isn't on this list. If you use it, turn on Just-in-time provisioning instead. It creates a Tomba account the first time someone signs in with SSO. See SSO Enforcement Modes.

Generate a token

A token is a long secret code that lets your identity provider connect to Tomba.

  1. Click Generate token.

  2. If you want, enter a Name so you can tell connections apart later, such as Okta production.

  3. Click Generate.

  4. Copy the token and keep it somewhere safe.

  5. Click Done. If you didn't use the copy button, tick I've saved this token somewhere safe first.

⚠️ Important: You only see the token once. If you lose it, generate a new one.

Connect your identity provider

In your identity provider's admin console, open the SCIM settings for your Tomba app and enter these values. The first two are also under Connection on the SCIM page.

Setting

Value

SCIM base URL

https://app.tomba.io/scim/v2

Authentication

Bearer token

Token

The token you generated

The exact steps depend on your provider, so check its help pages.

What SCIM does

Once connected, your identity provider can:

  • Create members in your Tomba workspace.

  • Update their details, such as their name.

  • Deactivate them in your Tomba workspace.

People added this way show a SCIM label on the Members page.

Manage your tokens

The Tokens list on Settings > SCIM shows each token's name, when it was created and when it was last used.

  • To stop a token, click Revoke, then Revoke token. Any connection using it stops adding or updating members right away.

  • To replace a token, generate a new one and update it in your identity provider.

💡 Tip: Give each identity provider connection its own token. Try SCIM with one person before you turn it on for everyone.

Related articles

Did this answer your question?