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

# Create a new alias.

`POST /identity/alias`

## Request body

- IdentityAliasRequest
  - `canonical_id` string — Entity ID to which this alias belongs to
  - `entity_id` string — Entity ID to which this alias belongs to. This field is deprecated in favor of 'canonical_id'.
  - `id` string — ID of the alias
  - `mount_accessor` string — Mount accessor to which this alias belongs to
  - `name` string — Name of the alias

## 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/revisions/bd8194de0697/schema)