---
title: "Provision a SCIM enterprise group"
method: POST
path: "/scim/v2/enterprises/{enterprise}/Groups"
tags: ["enterprise-admin"]
---

# Provision a SCIM enterprise group

`POST /scim/v2/enterprises/{enterprise}/Groups`

Creates a SCIM group for an enterprise.

When members are part of the group provisioning payload, they're designated as external group members. Providers are responsible for maintaining a mapping between the `externalId` and `id` for each user.

## Path parameters

- `enterprise` string, required

## Request body

- Group
  - `schemas` string[], required — The URIs that are used to indicate the namespaces of the SCIM schemas.
  - `externalId` string, required — A unique identifier for the resource as defined by the provisioning client.
  - `displayName` string, required — A human-readable name for a security group.
  - `members` object[] — The group members.
    - `value` string, required — The local unique identifier for the member
    - `displayName` string, required — The display name associated with the member

## Response `201`

Group has been created

## Other responses

- `400` — Bad request
- `401` — Authorization failure
- `403` — Permission denied
- `409` — Duplicate record detected
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-2.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-2/versions/8ae6d0c8716e/schema)