Use SCIM for provisioning teams

  • Updated

Opti ID streamlines the management of your Content Marketing Platform (CMP) and Optimizely Collaboration teams through SCIM. This article explains how to use SCIM to create and manage teams, including automatic provisioning and deprovisioning of users, to help you organize users and control access within CMP and Collaboration.

Prerequisites

Configure SCIM provisioning for your organization.

Naming convention

Use the following displayName format to create a name through SCIM:

<TeamName>::<InstanceID>

The following table explains the format:

Component Description
TeamName The desired name of your team
:: Required delimiter, a double colon
InstanceID The ID of the CMP or Collaboration product you associate the team with

The following is an example of a SCIM request body:

{
 "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"],
 "displayName": "Marketing Team::abc123-def456",
 "members": [
   {
     "value": "<user-id>"
   }
 ]
}

After creation

When you create a team successfully, you can rename the group to remove the delimiter and the Instance ID. The :: naming convention is only required during creation. 

If the team does not display in the Admin Center after you sync, check your SCIM logs. The system returns a 404 error if it cannot detect the Instance ID of your organization or if it does not belong to a teams-enabled product. 

Find the Instance ID in the Admin Center

Go to the Admin Center to find the Instance ID of your CMP or Collaboration product instance. See the following example for a CMP instance: 

  1. Go to Products > Content Marketing Platform and select the instance you want to assign to the team. 

  2. Click Details and view the Id at the bottom of the section.  

    image-20260303-192728.png

View and filter SCIM teams

After you configure SCIM to manage your team in Opti ID, you must provision and deprovision users in the team through your upstream IDP. 

  1. Open the Teams tab to view your SCIM team. 

  2. Alternatively, go to Teams > Teams Access and search for your team by entering the team name. 

  3. Choose SCIM from the Team Types drop-down list to view SCIM teams only.