# Create group

`POST https://api.airtable.com/scim/v2/Groups`

Create a new group from a [SCIM Group](https://datatracker.ietf.org/doc/html/rfc7643#section-4.2) object.

This endpoint creates a group with no members. Use the [patch group](https://airtable.com/developers/web/api/patch-scim-group.md) or [put group](https://airtable.com/developers/web/api/put-scim-group.md) endpoints to populate the new group with members.

## Requirements

- **Authentication:** [Personal access token](https://airtable.com/developers/web/api/authentication.md#types-of-token), [OAuth integration](https://airtable.com/developers/web/api/authentication.md#types-of-token)
- **Scope:** [`enterprise.scim.usersAndGroups:manage`](https://airtable.com/developers/web/api/scopes.md#enterprise-scim-users-and-groups-manage)
- **User role:** Enterprise admin _Note: Admins of multiple enterprises should use a service account's token when calling this route._
- **Billing plans:** Enterprise (pre-2023.08 legacy plan), Enterprise Scale

## Request body

- `schemas: array<string>` — required

  A list of schemas, including at least SCIM's core group schema URI.

- `displayName: string | null` — required

  Becomes the displayName of the group in Airtable. It must not be in use already.

## Response format

- `id: string` — required

  A user group ID

- `schemas: array<string>` — required

  A list of schemas, including at least SCIM's core group schema URI.

- `displayName: string | null` — required

  Becomes the displayName of the group in Airtable. It must not be in use already.

### Example — Create user group example

```sh
curl -X POST "https://api.airtable.com/scim/v2/Groups" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
--data '{
    "displayName": "ExampleGroup",
    "schemas": [
      "urn:ietf:params:scim:schemas:core:2.0:Group"
    ]
  }'
```

```json
{
  "displayName": "ExampleGroup",
  "id": "ugpEOS67LautSwEKM",
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:Group"
  ]
}
```