---
title: Setting up SCIM for User Management in Brevity
description: Learn how to configure SCIM between Okta and Brevity to automate user provisioning, deprovisioning, and team management while keeping identities in sync.
---

[Skip to content](https://support.brevitypitch.com/en-us/knowledgebase/scim-okta-setup#main-content)

![](https://support.brevitypitch.com/hs-fs/hubfs/Brevlogo.png?width=200&height=51&name=Brevlogo.png)

Open main navigation

Close main navigation

- [Contact us](mailto:support@brevitypitch.com)

[Contact us](mailto:support@brevitypitch.com)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Brevity Knowledge Base](https://support.brevitypitch.com/en-us/knowledgebase?hsLang=en-us)
2. [IT, Security, & Compliance](https://support.brevitypitch.com/en-us/knowledgebase/it-security-compliance?hsLang=en-us)
3. [Network & Access](https://support.brevitypitch.com/en-us/knowledgebase/it-security-compliance?hsLang=en-us#network-access)

# Setting up SCIM for User Management in Brevity

## Automated user and team lifecycle management between Okta and Brevity using SCIM

If your organization uses Okta to manage the access of your employees to tools and services, you can use the Okta **Provisioning** feature. Okta then gives your users access to Brevity automatically. This article tells you how to set up Brevity and Okta.

### Table of Contents

1. [Integration Features](https://support.brevitypitch.com/en-us/knowledgebase/scim-okta-setup#integration-features)
   
     1. User Provisioning and Lifecycle Management
2. [Supported SCIM Attributes](https://support.brevitypitch.com/en-us/knowledgebase/scim-okta-setup#supported-attributes)
3. [Step-by-Step Configuration](https://support.brevitypitch.com/en-us/knowledgebase/scim-okta-setup#configuration-steps) 
     1. Generate the SCIM Token in Brevity
     2. Configure Provisioning in Okta
     3. Helpful links to Okta Documentation
4. [Import existing Brevity users into Okta](https://support.brevitypitch.com/en-us/knowledgebase/scim-okta-setup#import-users)
5. [FAQ](https://support.brevitypitch.com/en-us/knowledgebase/scim-okta-setup#faq) 
     1. Who can manage SCIM settings in Brevity?
     2. I already have an existing Organization in Brevity with active members. How do I enable SCIM provisioning without creating duplicates?
     3. Can I manually delete or manage users in Brevity once SCIM is enabled?
     4. Does deleting a user in Okta also delete the user in Brevity?

### Integration Features

The SCIM connection between Okta and Brevity adds, updates and deactivates users and their group memberships automatically.

**Organization-Level Scope:** The SCIM connection applies to one Brevity organization. All users and teams that Okta sends through this connection belong to the Brevity organization of the SCIM token.

This connection supports these features:

#### User Provisioning and Lifecycle Management

- **Create Users:** When you assign a person to the Brevity app in Okta, Okta creates the user in your Brevity organization.
  
  If the person already has a Brevity account and is not a member of your organization, Brevity does not add the account. Brevity emails the person an invitation to your organization, and Okta shows a provisioning error for that person. The error says that a Brevity account with this email already exists. The person joins your organization when they accept the invitation. After they accept, retry the provisioning of that person in Okta.
- **Update User Attributes:** When you change the first name, last name or email of a user in Okta, Okta sends the change to Brevity. Brevity does not store other profile fields, for example the job title.
- **De-provision Users (Membership Deactivation)**: When you unassign a user from the Brevity app in Okta, or deactivate the Okta account, Brevity **deactivates the user’s membership in your organization**. The Brevity account of the user stays active, but **the user cannot access your organization or its teams**. Brevity keeps all historical data.

 

### Supported SCIM Attributes

Brevity uses these attributes from Okta. Only `userName` is required. If Okta sends no email, Brevity uses `userName` as the email.

 

| Attribute | Description | Required |
| --- | --- | --- |
| `userName` | The user's unique identifier (typically their email address). | Yes |
| `emails[type eq "work"]` | The primary work email address for notifications and login. | No |
| `name.givenName` | The user's first name. | No |
| `name.familyName` | The user's last name. | No |
| `active` | Whether the membership of the user in your Brevity organization is active. If Okta does not send it, Brevity uses `true`. | No |

 

 

 

### Step-by-Step Configuration

#### Generate the SCIM Token in Brevity

**Note:** Only organization admins can see the SCIM settings and generate a SCIM token.

1. Sign in to Brevity as an organization admin.
2. Click your company's logo in the bottom-left of the Brevity window, then click **View Organization**.
3. Make sure that **All Organization** is selected.
4. Click the **Settings** tab.
5. Click **Sign-in and SSO**.
6. Turn on the **Automatic user provisioning (SCIM)** switch.
   
   ![Automatic user provisioning (SCIM) card with the switch on and the Generate token button](https://support.brevitypitch.com/hs-fs/hubfs/kb-org-page-2026-11/kb-org-page-settings-scim-off.png?width=670&name=kb-org-page-settings-scim-off.png)
7. Click **Save**.

**Caution:** Brevity shows the SCIM token one time only. Copy it before you leave or reload the page.

1. Click **Generate token**.
2. In the dialog, click **Generate token**.
3. Copy the **SCIM URL** and the **SCIM token**.
   
   ![Automatic user provisioning (SCIM) card with the SCIM URL and token](https://support.brevitypitch.com/hs-fs/hubfs/kb-org-page-2026-11/kb-org-page-settings-scim-token.png?width=670&name=kb-org-page-settings-scim-token.png)

If you lose the token, click **Replace token**, then click **Replace token** in the dialog. The old token stops working. Enter the new token in Okta.

#### Configure Provisioning in Okta

**Caution:** If your Brevity organization already has members, import them into Okta before you turn on **Create Users**. Do steps 1 to 7. Then do the steps in "Import existing Brevity users into Okta". Then do steps 8 to 11.

**Note on Deactivation Behavior**  
When Okta deactivates a user, Brevity deactivates the membership of the user in your organization. Brevity does not delete the Brevity account of the user. The historical data and audit records stay.

1. In the Okta Admin Console, open the Brevity app.
2. Click the **Provisioning** tab.
3. Click **Configure API Integration**.
4. Select **Enable API Integration**.
   
   ![](https://support.brevitypitch.com/hs-fs/hubfs/image-png-Jan-20-2026-09-01-19-5195-PM.png?width=670&height=549&name=image-png-Jan-20-2026-09-01-19-5195-PM.png)
5. In the **Base URL** field, paste the **SCIM URL** from Brevity.
6. In the **API Token** field, paste the **SCIM token** from Brevity.
7. Click **Test API Credentials**. When Okta confirms the connection, click **Save**.

**Caution:** If your Brevity organization already has members, stop here. Do the steps in "Import existing Brevity users into Okta" before step 8.

1. Under **Provisioning**, click **To App**.
   
   ![](https://support.brevitypitch.com/hs-fs/hubfs/image-png-Jan-20-2026-09-03-45-7523-PM.png?width=670&height=496&name=image-png-Jan-20-2026-09-03-45-7523-PM.png)
2. Click **Edit**.
3. Turn on these options:
   
     1. **Create Users**
     2. **Update User Attributes**
     3. **Deactivate Users**
4. Click **Save**.
   
   ![](https://support.brevitypitch.com/hs-fs/hubfs/image-png-Jan-20-2026-09-06-05-1275-PM.png?width=670&height=559&name=image-png-Jan-20-2026-09-06-05-1275-PM.png)

 

### Import existing Brevity users into Okta

When SCIM provisioning is on, the Brevity app in the Okta Admin Console has an **Import** tab. Import lets Okta *read the users of your Brevity organization into Okta*. Provisioning sends users in the other direction, from Okta to Brevity.

#### What Import does

- **Import** reads the users that already exist in your Brevity organization. Okta can then match or assign them.
- Provisioning (**To App**) sends users from Okta to Brevity. Import goes in the other direction (**To Okta**).
- During an import, Okta tries to *match* each Brevity user to an Okta user. If Okta finds a match, Okta links the two users. If Okta finds no match, Okta can create a new Okta user.

#### Why you import

Import **links each existing Brevity user to an Okta user**:

- If a user exists in Brevity before you set up provisioning, the import finds that user and **links the Brevity user to the Okta user**.
- After the link, Okta knows which Brevity user belongs to which Okta user. Okta then updates and deactivates that Brevity user, and does not try to create the user again.

#### How to use Import

1. In the Okta Admin Console, open the Brevity app.
2. Click the **Import** tab.
3. Click **Import Now**. Okta reads the users from Brevity and asks you to review the matches before you confirm.
   
   ![](https://support.brevitypitch.com/hs-fs/hubfs/image-png-Jan-20-2026-09-36-05-4677-PM.png?width=670&height=542&name=image-png-Jan-20-2026-09-36-05-4677-PM.png)

Tips

- After the import, make sure that Okta linked each Brevity user to the correct Okta user.

**Important:** Import brings in **users only**.  
Import does not bring Brevity teams into Okta.

#### Helpful links to Okta Documentation:

- [Overview of lifecycle management in the OIN | Okta Developer](https://developer.okta.com/docs/guides/oin-lifecycle-mgmt-overview/)
- [Understanding SCIM | Okta Developer](https://developer.okta.com/docs/concepts/scim/)

### FAQ

**Q: Who can manage SCIM settings in Brevity?**

A: Only organization admins can see the **Automatic user provisioning (SCIM)** card in **Settings** \> **Sign-in and SSO**. Only they can turn SCIM on or off and generate a SCIM token. If you do not see the card, contact an organization admin of your organization.

**Q: I already have an existing Organization in Brevity with active members. How do I enable SCIM provisioning without creating duplicates?**

A: Do these steps in this order:

1. **Turn on SCIM:** In Brevity, go to **Settings** \> **Sign-in and SSO**. Turn on **Automatic user provisioning (SCIM)**. Click **Save**. Click **Generate token**. Then connect Okta to Brevity (steps 1 to 7 of "Configure Provisioning in Okta").
2. **Run an import:** Before you turn on **Create Users** or **Update User Attributes** in Okta, go to the **Import** tab of the Brevity app in the Okta Admin Console. Click **Import Now**.
3. **Confirm the matches:** Okta reads the list of existing members from Brevity. Match each member to the correct Okta user. This links each Okta user to the SCIM id of the Brevity user.
4. **Turn on provisioning:** After Okta links the existing users, go to the **Provisioning** tab. Turn on **Create Users**, **Update User Attributes** and **Deactivate Users**. Okta then controls the existing accounts and does not try to create them again.

**Q: Can I manually delete or manage users in Brevity once SCIM is enabled?**

**Caution:** When SCIM is on, Okta controls your users. If you change a user in Brevity, Okta can replace the change. Add, change and remove users in Okta.

A: You can still open the user settings in Brevity, but we recommend that you manage all users in Okta.

- **Okta controls the users:** When SCIM is on, Okta controls your user data. Okta can replace a change that you make in Brevity, for example a member that you deactivate, at its next update.
- **Deactivation:** To remove the access of a user, unassign the user from the Brevity app in Okta, or deactivate the Okta account. Brevity then deactivates the membership of the user.
- **Consistency:** When you manage users in Okta, the audit logs, team memberships and organization access in Brevity agree with Okta.

**Q: Does deleting a user in Okta also delete the user in Brevity?**

A: No. Okta de-provisioning results in **organization membership deactivation**, not user deletion.

- **What happens:** When you delete or deactivate a user in Okta, or unassign the user from the Brevity app, Brevity deactivates the membership of the user in your organization.
- **Account status:** The Brevity account of the user stays active, but the user has **no access** to your organization or its teams.
- **Data preservation:** Brevity keeps all historical activity (content, comments, audit logs).
- **Reactivation:** If you assign the same user in Okta again, Okta can reactivate the membership in your organization. No data is lost.

- [New Features and Updates](https://support.brevitypitch.com/en-us/knowledgebase/new-features-and-updates?hsLang=en-us#main-content)

    - [Training Plans](https://support.brevitypitch.com/en-us/knowledgebase/new-features-and-updates?hsLang=en-us#training-plans)
    - [Meeting Analyzer](https://support.brevitypitch.com/en-us/knowledgebase/new-features-and-updates?hsLang=en-us#meeting-analyzer)
    - [Role Play](https://support.brevitypitch.com/en-us/knowledgebase/new-features-and-updates?hsLang=en-us#role-play)
    - [Administration](https://support.brevitypitch.com/en-us/knowledgebase/new-features-and-updates?hsLang=en-us#administration)
- [Overview & Getting Started](https://support.brevitypitch.com/en-us/knowledgebase/overview-getting-started?hsLang=en-us#main-content)

    - [What is Brevity?](https://support.brevitypitch.com/en-us/knowledgebase/overview-getting-started?hsLang=en-us#what-is-brevity)
    - [Getting Started](https://support.brevitypitch.com/en-us/knowledgebase/overview-getting-started?hsLang=en-us#getting-started)
- [Admin & Enablement](https://support.brevitypitch.com/en-us/knowledgebase/admin-enablement?hsLang=en-us#main-content)

    - [Managing Users, Teams, & User Groups](https://support.brevitypitch.com/en-us/knowledgebase/admin-enablement?hsLang=en-us#managing-users-teams-user-groups)
    - [Admin Settings](https://support.brevitypitch.com/en-us/knowledgebase/admin-enablement?hsLang=en-us#admin-settings)
    - [Enablement Best Practices](https://support.brevitypitch.com/en-us/knowledgebase/admin-enablement?hsLang=en-us#enablement-best-practices)
    - [User Logs](https://support.brevitypitch.com/en-us/knowledgebase/admin-enablement?hsLang=en-us#user-logs)
    - [Integrations](https://support.brevitypitch.com/en-us/knowledgebase/admin-enablement?hsLang=en-us#integrations)
    - [Managing Users & Teams](https://support.brevitypitch.com/en-us/knowledgebase/admin-enablement?hsLang=en-us#managing-users-teams)
- [Using Brevity](https://support.brevitypitch.com/en-us/knowledgebase/using-brevity?hsLang=en-us#main-content)

    - [Agent Hub](https://support.brevitypitch.com/en-us/knowledgebase/using-brevity?hsLang=en-us#agent-hub)
    - [Creating Role Plays](https://support.brevitypitch.com/en-us/knowledgebase/using-brevity?hsLang=en-us#creating-role-plays)
    - [Creating & Managing Assignments](https://support.brevitypitch.com/en-us/knowledgebase/using-brevity?hsLang=en-us#creating-managing-assignments)
    - [Creating Training Plans](https://support.brevitypitch.com/en-us/knowledgebase/using-brevity?hsLang=en-us#creating-training-plans)
    - [Repository](https://support.brevitypitch.com/en-us/knowledgebase/using-brevity?hsLang=en-us#repository)
    - [Practicing Role Plays](https://support.brevitypitch.com/en-us/knowledgebase/using-brevity?hsLang=en-us#practicing-role-plays)
    - [Working Through Your Training Plan](https://support.brevitypitch.com/en-us/knowledgebase/using-brevity?hsLang=en-us#working-through-your-training-plan)
    - [Meetings](https://support.brevitypitch.com/en-us/knowledgebase/using-brevity?hsLang=en-us#meetings)
    - [Playbook](https://support.brevitypitch.com/en-us/knowledgebase/using-brevity?hsLang=en-us#playbook)
- [Scores, Feedback, & Analytics](https://support.brevitypitch.com/en-us/knowledgebase/scores-feedback-analytics?hsLang=en-us#main-content)

    - [Viewing Feedback](https://support.brevitypitch.com/en-us/knowledgebase/scores-feedback-analytics?hsLang=en-us#viewing-feedback)
    - [Interpreting Results](https://support.brevitypitch.com/en-us/knowledgebase/scores-feedback-analytics?hsLang=en-us#interpreting-results)
    - [Reporting & Analytics](https://support.brevitypitch.com/en-us/knowledgebase/scores-feedback-analytics?hsLang=en-us#reporting-analytics)
    - [Training Plans](https://support.brevitypitch.com/en-us/knowledgebase/scores-feedback-analytics?hsLang=en-us#training-plans)
- [IT, Security, & Compliance](https://support.brevitypitch.com/en-us/knowledgebase/it-security-compliance?hsLang=en-us#main-content)

    - [Network & Access](https://support.brevitypitch.com/en-us/knowledgebase/it-security-compliance?hsLang=en-us#network-access)
- [Troubleshooting](https://support.brevitypitch.com/en-us/knowledgebase/troubleshooting?hsLang=en-us#main-content)

    - [Account & Access Issues](https://support.brevitypitch.com/en-us/knowledgebase/troubleshooting?hsLang=en-us#account-access-issues)
    - [Audio & Role Play Issues](https://support.brevitypitch.com/en-us/knowledgebase/troubleshooting?hsLang=en-us#audio-role-play-issues)
    - [Assignments & Scoring](https://support.brevitypitch.com/en-us/knowledgebase/troubleshooting?hsLang=en-us#assignments-scoring)
    - [Integrations](https://support.brevitypitch.com/en-us/knowledgebase/troubleshooting?hsLang=en-us#integrations)
- [Known Issues & Status](https://support.brevitypitch.com/en-us/knowledgebase/known-issues-status?hsLang=en-us#main-content)

    - [Active Known Issues](https://support.brevitypitch.com/en-us/knowledgebase/known-issues-status?hsLang=en-us#active-known-issues)
    - [Resolved Known Issues](https://support.brevitypitch.com/en-us/knowledgebase/known-issues-status?hsLang=en-us#resolved-known-issues)

[![](https://support.brevitypitch.com/hs-fs/hubfs/Brevlogo.png?width=200&height=51&name=Brevlogo.png)](http://brevitypitch.com)

The Revenue Performance Platform

<https://www.linkedin.com/company/brevitypitch> <https://x.com/brevitypitch> [mailto:support@brevitypitch.com](mailto:support@brevitypitch.com)

Copyright © 2025, Brevity Technologies, Inc.