Use the Shortcut SCIM app 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 and ask Shortcut Support for your Workspace ID and API token.
1. Add Shortcut SCIM App
- From your Okta Admin console, click Applications
- Select Browse App Catalog and search for Shortcut SCIM
- Click Shortcut SCIM and then Add Integration
- 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
- Navigate to Provisioning settings for Shortcut SCIM
- Click Configure API Integration
- Check Enable API Integration
- Enter the Workspace ID from support
- Enter the API Token from support
- Click Test API Credentials
- If successful, click Save
3. Enable Provisioning Features
- In Provisioning settings, go to the To App section
- Click Edit
- Select the features you want to enable
- Click Save
4. Push Groups (optional)
To keep Shortcut Teams in sync with Okta groups:
- Open the Push Groups tab of the Shortcut SCIM app
- Click Push Groups and find the group by name or by rule
- 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:
- Go to the Sign On settings tab
- Set Application username format to Email
- Click Save
Advanced: Custom Username Field in Okta
By default, the userName field is locked to the Okta user’s email. To customize:
- Contact Okta support at support.okta.com
- Request to disable the Feature Flag CONSOLIDATE_USERNAME_EL
- Once disabled, you can map a custom attribute for
userName
See the SCIM overview for supported attributes and troubleshooting.