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

# Provision a SCIM enterprise group

`POST /scim/v2/Groups`

**Note:** The SCIM API endpoints for enterprise accounts are currently in *private* beta and are subject to change.

Creates a SCIM group for an enterprise.

If members are included as part of the group provisioning payload, they will be created as external group members. It is up to a provider to store a mapping between the `externalId` and `id` of each user.

## 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[], required — 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-5.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-5/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-5/versions/50ae54440071/schema)