---
title: "Create User Group"
method: POST
path: "/api/scim/v3/Groups"
tags: ["User Groups V3"]
---

# Create User Group

`POST /api/scim/v3/Groups`

Use this API to create a user group. This API should only be used when provisioning and managing users from your Identity Provider using the System for Cross-Domain Identity Management (SCIM) standard to facilitate the automated creation of user identities from a third-party identity management application.

> 🗒 Things to Know
>
> - This API supports OneTrust's Enhanced SCIM Integration that leverages Group Provisioning to manage access for users by provisioning them to one or more user groups. For more information, see [SCIM User & Group Provisioning](https://my.onetrust.com/s/article/UUID-93f936ef-8076-280c-a58e-ba2d3437dfad).

## Request body

- GroupResource
  - `id` string, uuid — Unique identifier for the user created by the OneTrust application.
  - `externalId` string — External Id
  - `meta` Meta
    - `created` string, date-time — The date and time when the resource was created
    - `lastModified` string, date-time — The date and time when the resource was last modified
    - `location` string, uri — The URL for the resource
    - `version` string — The version of the resource
    - `attributes` unknown[]
      - unknown
    - `resourceType` 'User' | 'Group' | 'ResourceType' | 'ServiceProviderConfig' | 'Schema' — The resource type
  - `schemas` string[]
  - `displayName` string, required — Assessments Manager - ADFS
  - `members` Member[]
    - `value` string, uuid, required — The unique ID of the user that you want to add to the Group.
    - `type` 'User' — The type of the resource.
    - `$ref` string, url — A hyperlink to the resource
  - `urn:ietf:params:scim:schemas:onetrust:Group` OneTrustGroup
    - `category` string — The display name of the group
    - `description` string — The description of the group

## Response `201`

Created

Group created successfully.

- GroupResource
  - `id` string, uuid — Unique identifier for the user created by the OneTrust application.
  - `externalId` string — External Id
  - `meta` Meta
    - `created` string, date-time — The date and time when the resource was created
    - `lastModified` string, date-time — The date and time when the resource was last modified
    - `location` string, uri — The URL for the resource
    - `version` string — The version of the resource
    - `attributes` unknown[]
      - unknown
    - `resourceType` 'User' | 'Group' | 'ResourceType' | 'ServiceProviderConfig' | 'Schema' — The resource type
  - `schemas` string[]
  - `displayName` string, required — Assessments Manager - ADFS
  - `members` Member[]
    - `value` string, uuid, required — The unique ID of the user that you want to add to the Group.
    - `type` 'User' — The type of the resource.
    - `$ref` string, url — A hyperlink to the resource
  - `urn:ietf:params:scim:schemas:onetrust:Group` OneTrustGroup
    - `category` string — The display name of the group
    - `description` string — The description of the group

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)