---
title: "Create Group"
method: POST
path: "/Groups"
tags: ["Groups"]
---

# Create Group

`POST /Groups`

## Request

- Base URL: `https://api.oneflow.com/scim/v1`
- URL: `https://api.oneflow.com/scim/v1/Groups`
- Auth: HTTP bearer

Use this endpoint to create a group. See [Group](doc:data-model#group) for more information.

## Query parameters

- `attributes` string
- `excludedAttributes` string

## Request body

- Group: Represents a group.
  - `displayName` string: A human-readable name for the Group.
  - `externalId` string, nullable: A custom, user-supplied ID.
  - `id` string: The ID of this resource instance.
  - `members` object[]: A list of members of the Group.
    - `type` string: The name of the resource type of the resource. Always 'User'.
    - `value` string: The ID of the user.
    - `x-ref` string: The URI of the corresponding 'User' resource.
    - `display` string, nullable: Compatibility field, accepted but discarded.
  - `meta` object, nullable: An object containing group metadata properties.
    - `created` string, datetime: The time when the group was created.
    - `lastModified` string, datetime: The time when the group was last modified.
    - `location` string: The URI of the group being returned.
    - `resourceType` string: The name of the resource type of the resource. Always 'Group'.
  - `schemas` string[]: A schema for representing the group's configuration.

## Response `201`

Returns the created group, optionally filtered by values in attributes or excludedAttributes parameters.

- Group: Represents a group.
  - `displayName` string: A human-readable name for the Group.
  - `externalId` string, nullable: A custom, user-supplied ID.
  - `id` string: The ID of this resource instance.
  - `members` object[]: A list of members of the Group.
    - `type` string: The name of the resource type of the resource. Always 'User'.
    - `value` string: The ID of the user.
    - `x-ref` string: The URI of the corresponding 'User' resource.
    - `display` string, nullable: Compatibility field, accepted but discarded.
  - `meta` object, nullable: An object containing group metadata properties.
    - `created` string, datetime: The time when the group was created.
    - `lastModified` string, datetime: The time when the group was last modified.
    - `location` string: The URI of the group being returned.
    - `resourceType` string: The name of the resource type of the resource. Always 'Group'.
  - `schemas` string[]: A schema for representing the group's configuration.

## Other responses

- `400`: Invalid format or content of the request.
- `401`: The SCIM token is invalid.
- `409`: A conflict occurred with the current state of the target resource.

---

[API](https://skmtc.dev/oneflow/apis/scim-api-for-oneflow.md) - [All operations](https://skmtc.dev/oneflow/apis/scim-api-for-oneflow/llms.txt) - [OpenAPI document](https://skmtc.dev/oneflow/apis/scim-api-for-oneflow/revisions/4373300e62fb?raw)