---
title: Use SCIM for provisioning teams
slug: opti-id/docs/use-scim-for-provisioning-teams
docTags: 
createdAt: 2026-07-30T20:38:23.419Z
---

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:

```text
<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:

```json
{
 "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](https://support.optimizely.com/hc/en-us/articles/28917253738381-Activity-log). 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.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/HFfm0n4Kcaht2zNc7tUqb_opti-id-instance-id.png)

## View and filter SCIM teams

:::hint{type="info"}
**Note**

After you configure SCIM to manage your team in Opti ID, you must [provision and deprovision users](https://support.optimizely.com/hc/en-us/articles/32769522265485-Overview-of-SCIM-provisioning-for-Opti-ID#h_01JF8RDRC23Q9NXPY4VJCX9MKJ) in the team through your upstream IdP.
:::

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

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/XQ4l1Q44pZm5XO_QqFWmZ_44328538592653.png)
2. Alternatively, go to **Teams > Teams Access** and search for your team by entering the team name.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ygk27Sk-anLNkXWzUgJjk_44328549704333.png)
3. Choose **SCIM** from the **Team Types** drop-down list to view SCIM teams only.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/rQYeYWyz5yDIgdsrPbX22_44328549705357.png)