---
title: "Create SCIM group"
method: POST
path: "/v1/provisioning/scim/Groups"
tags: ["Accounts and users"]
---

# Create SCIM group

`POST /v1/provisioning/scim/Groups`

## Request

- Base URL: `https://yourbaseurl.talon.one`
- URL: `https://yourbaseurl.talon.one/v1/provisioning/scim/Groups`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/talon/apis/management-api/docs/v1/provisioning/scim/Groups/post.ts> (a function with typed inputs; its response is checked against the schema)

> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Create a new Talon.One group using the SCIM Group provisioning protocol with an identity provider, for example, Microsoft Entra ID, and assign members from the payload to the new group.
In Talon.One, a `Group` corresponds to a [role](https://docs.talon.one/docs/product/account/account-settings/managing-roles), and `members` are the [users](https://docs.talon.one/docs/product/account/account-settings/managing-users) assigned to that role.

## Request body

- ScimBaseGroup: Define the schema for base fields in a group using the SCIM provisioning protocol. Talon.One uses this schema to create roles.
  - `displayName` string: Display name of the group (Talon.One role).
  - `members` ScimGroupMember[]: List of members to assign to the new Talon.One role.
    - `value` string: Unique identifier of the member.
    - `display` string: Identifier of the user. This is usually an email address.

## Response `201`

Created

- ScimGroup: Define the schema for base fields in a group using the SCIM provisioning protocol. Talon.One uses this schema to create roles.
  - `displayName` string: Display name of the group (Talon.One role).
  - `members` ScimGroupMember[]: List of members to assign to the new Talon.One role.
    - `value` string: Unique identifier of the member.
    - `display` string: Identifier of the user. This is usually an email address.
  - `id` string, required: ID of the group.

---

[API](https://skmtc.dev/talon/apis/management-api.md) - [All operations](https://skmtc.dev/talon/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/talon/apis/management-api/revisions/7ef1b9504c3a?raw)