---
title: "POST /identity/group/name/{name}"
method: POST
path: "/identity/group/name/{name}"
tags: ["identity"]
---

# POST /identity/group/name/{name}

`POST /identity/group/name/{name}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/lensesio/apis/hashicorp-vault-api/docs/identity/group/name/:name/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- IdentityGroupNameRequest
  - `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
  - `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.dev/lensesio/apis/hashicorp-vault-api.md) - [All operations](https://skmtc.dev/lensesio/apis/hashicorp-vault-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lensesio/apis/hashicorp-vault-api/revisions/bd8194de0697?raw)