---
title: "Create a new group."
method: POST
path: "/identity/group"
tags: ["identity"]
---

# Create a new group.

`POST /identity/group`

## Request body

- IdentityGroupRequest
  - `id` string — ID of the group. If set, updates the corresponding existing group.
  - `member_entity_ids` string[] — Entity IDs to be assigned as group members.
  - `member_group_ids` string[] — Group IDs to be assigned as group members.
  - `metadata` object — Metadata to be associated with the group. In CLI, this parameter can be repeated multiple times, and it all gets merged together. For example: vault <command> <path> metadata=key1=value1 metadata=key2=value2
  - `name` string — Name of the group.
  - `policies` string[] — Policies to be tied to the group.
  - `type` string — Type of the group, 'internal' or 'external'. Defaults to 'internal'

## Response `200`

OK

---

[API](https://skmtc.net/lensesio/apis/hashicorp-vault-api.md) · [All operations](https://skmtc.net/lensesio/apis/hashicorp-vault-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lensesio/hashicorp-vault-api/versions/bd8194de0697/schema)