---
title: SCIM provisioning
description: Automatically provision and deprovision workspace members from your identity provider using SCIM 2.0.
---
<Banner variant="info">
SCIM directory provisioning is available on [Railway Enterprise](/enterprise) and eligible [committed spend plans](/pricing/committed-spend).
</Banner>

SCIM directory provisioning syncs user membership from your organization's identity provider (IdP) to your Railway workspace. Assigning someone in your identity provider adds them to the workspace, and unassigning or deactivating them revokes their workspace access automatically.

## How directory provisioning works

Railway uses SCIM 2.0 (via WorkOS Directory Sync) to keep workspace membership aligned with your identity provider, including Okta, Microsoft Entra ID, Google Workspace, JumpCloud, OneLogin, PingFederate, Rippling, and custom SCIM 2.0 integrations.

Before enabling provisioning, your workspace must have:

- [SAML Single Sign-On](/enterprise/saml) enabled on the workspace
- At least one [verified email domain](/projects/workspaces#trusted-domains) in **Security** settings

When directory provisioning is enabled:

- Assigning an active user whose email matches a verified workspace domain creates or links their Railway account and grants them the `Member` workspace role.
- Turning on directory provisioning automatically turns off domain-based automatic joining so your identity provider controls who joins the workspace.
- Railway tracks which memberships were granted by SCIM separately from manual invitations. Manually added members keep their access unless a workspace admin removes them.
- Railway refuses to deprovision the last workspace `Admin`. Keep at least one manually added workspace admin account for recovery.
- Workspace role changes (such as promoting a member to `Admin` or `Deployer`) and [access groups](/enterprise/access-groups) are managed in Railway rather than synced from identity provider groups.

## Configure directory provisioning

You must be a workspace admin with access to your identity provider's admin console to set up SCIM provisioning.

1. Navigate to your workspace <a href="https://railway.com/workspace/security" target="_blank">**Security** settings</a>.
2. Under **Verified email domains**, verify your organization's email domain if you haven't already.
3. Ensure **Single sign-on** is enabled for the workspace.
4. Under **Directory provisioning (SCIM)**, click **Connect directory** to open the guided setup portal.
5. Follow the instructions for your identity provider to configure the SCIM 2.0 endpoint URL and bearer token, then return to Railway.
6. Click **Check connection** if needed until the status shows **Directory connected. Ready to enable provisioning.**
7. Click **Enable provisioning** to begin syncing assigned users.
8. Assign a user to the Railway application in your identity provider and confirm they appear on the workspace <a href="https://railway.com/workspace/people" target="_blank">**People** page</a>.

## Deprovision members

When you unassign, suspend, or delete a SCIM-managed user in your identity provider, Railway removes them from the workspace automatically.

Deprovisioning a member from a workspace:

- Removes their workspace membership and direct project permissions
- Removes them from workspace [access groups](/enterprise/access-groups)
- Revokes workspace API tokens created by that member
- Deletes workspace automations and cloud agents owned by that member
- Blocks the user from rejoining via domain-based joining or older workspace invite links

**Note:** If a SCIM-deprovisioned person needs manual access later, a workspace admin must send them a new direct email invitation from the **People** page. Pair SCIM provisioning with [SAML SSO enforcement](/enterprise/saml#enforcing-saml-sso) so active browser sessions must also authenticate through your identity provider.

## Manage, pause, or retry sync

You can monitor and control directory sync from <a href="https://railway.com/workspace/security" target="_blank">**Security** settings</a> under **Directory provisioning (SCIM)**:

- **Check for changes / Retry provisioning:** Triggers an immediate directory reconciliation and retries any failed or blocked membership operations (for example, after verifying an additional email domain).
- **Pause provisioning:** Stops processing new directory events while allowing any in-progress membership changes to finish. Domain-based automatic joining remains disabled while provisioning is paused. Click **Resume provisioning** to continue syncing.
- **Manage directory:** Opens the setup portal to rotate SCIM credentials or inspect your directory connection.
- **Replace a directory:** If you delete or disconnect a directory, Railway revokes memberships managed by that directory before allowing you to connect a replacement directory.

## Related

- [SAML Single Sign-On](/enterprise/saml)
- [Workspaces and verified email domains](/projects/workspaces#trusted-domains)
- [Access groups](/enterprise/access-groups)
- [Audit logs](/enterprise/audit-logs)