# Set up SCIM with Okta

Connect the Shortcut SCIM app in Okta to a Shortcut Workspace to provision users and push groups as Teams.

Use the [Shortcut SCIM app](https://www.okta.com/integrations/shortcut-scim/) from the Okta catalog to create, update, and deactivate users in a Shortcut Workspace, and to push Okta groups as Shortcut Teams.

Before you begin, check the [SCIM requirements](/help/admin/scim#requirements) and ask [Shortcut Support](mailto:support@shortcut.com) for your Workspace ID and API token.

## 1. Add Shortcut SCIM App

1. From your Okta Admin console, click **Applications**
2. Select **Browse App Catalog** and search for **Shortcut SCIM**
3. Click **Shortcut SCIM** and then **Add Integration**
4. On the **General Settings** tab, check both:
   - *Do not display application icon to users*
   - *Do not display application icon in the Okta Mobile App*

> The Shortcut SCIM app is only for provisioning users. Login should be done via the Shortcut SAML app.

## 2. Configure SCIM Provisioning

1. Navigate to **Provisioning** settings for Shortcut SCIM
2. Click **Configure API Integration**
3. Check **Enable API Integration**
4. Enter the **Workspace ID** from support
5. Enter the **API Token** from support
6. Click **Test API Credentials**
7. If successful, click **Save**

## 3. Enable Provisioning Features

1. In **Provisioning** settings, go to the **To App** section
2. Click **Edit**
3. Select the features you want to enable
4. Click **Save**

## 4. Push Groups (optional)

To keep Shortcut Teams in sync with Okta groups:

1. Open the **Push Groups** tab of the Shortcut SCIM app
2. Click **Push Groups** and find the group by name or by rule
3. Click **Save**. Okta creates the Team, or links to an existing Team with the same name, and keeps its members in sync.

## 5. Configure SAML Application

Ensure your **Shortcut** SAML app has correct settings:

1. Go to the **Sign On** settings tab
2. Set **Application username format** to **Email**
3. Click **Save**

## Advanced: Custom Username Field in Okta

By default, the `userName` field is locked to the Okta user's email. To customize:

1. Contact Okta support at [support.okta.com](https://support.okta.com/help/s/?language=en_US)
2. Request to disable the Feature Flag **CONSOLIDATE_USERNAME_EL**
3. Once disabled, you can map a custom attribute for `userName`

See the [SCIM overview](/help/admin/scim) for supported attributes and troubleshooting.