---
title: "POST /{tenantID}/groups"
method: POST
path: "/{tenantID}/groups"
tags: ["Group"]
---

# POST /{tenantID}/groups

`POST /{tenantID}/groups`

Create a group in the directory.

## Path parameters

- `tenantID` string, required

## Query parameters

- `api-version` string, required

## Request body

- GroupCreateParameters — Request parameters for creating a new group.
  - `displayName` string, required — Group display name
  - `mailEnabled` false, required — Whether the group is mail-enabled. Must be false. This is because only pure security groups can be created using the Graph API.
  - `mailNickname` string, required — Mail nickname
  - `securityEnabled` true, required — Whether the group is a security group. Must be true. This is because only pure security groups can be created using the Graph API.

## Response `201`

Created

- ADGroup — Represents an Azure Active Directory object.
  - `deletionTimestamp` string, date-time, nullable — The time at which the directory object was deleted.
  - `objectId` string — The object ID.
  - `objectType` string, required — The object type.

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/windows/apis/graphrbac.md) · [All operations](https://skmtc.net/windows/apis/graphrbac/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windows/graphrbac/versions/003d8a5138c2/schema)