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

# Create a new entity

`POST /identity/entity`

## Request body

- IdentityEntityRequest
  - `disabled` boolean — If set true, tokens tied to this identity will not be able to be used (but will not be revoked).
  - `id` string — ID of the entity. If set, updates the corresponding existing entity.
  - `metadata` object — Metadata to be associated with the entity. 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 entity
  - `policies` string[] — Policies to be tied to the entity.

## 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)