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

# Create a new alias.

`POST /identity/entity-alias`

## Request body

- IdentityEntityAliasRequest
  - `canonical_id` string — Entity ID to which this alias belongs
  - `custom_metadata` object — User provided key-value pairs
  - `entity_id` string — Entity ID to which this alias belongs. This field is deprecated, use canonical_id.
  - `id` string — ID of the entity alias. If set, updates the corresponding entity alias.
  - `mount_accessor` string — Mount accessor to which this alias belongs to; unused for a modify
  - `name` string — Name of the alias; unused for a modify

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