---
title: "Create a new identity, and optionally, an access token."
method: POST
path: "/identities"
tags: ["Identity"]
---

# Create a new identity, and optionally, an access token.

`POST /identities`

Create a new identity, and optionally, an access token.

## Query parameters

- `api-version` string, required

## Request body

- CommunicationIdentityCreateRequest — Request to create a new identity with optional access token.
  - `createTokenWithScopes` CommunicationIdentityTokenScope[] — Also create access token for the created identity.
  - `expiresInMinutes` integer — Optional custom validity period of the token within [60,1440] minutes range. If not provided, the default value of 1440 minutes (24 hours) will be used.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- CommunicationIdentityAccessTokenResult — A communication identity with access token.
  - `identity` CommunicationIdentity, required — A communication identity.
    - `id` string, required — Identifier of the identity.
  - `accessToken` CommunicationIdentityAccessToken — An access token.
    - `token` string, required — The access token issued for the identity.
    - `expiresOn` string, date-time, required — The expiry time of the token.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** `6f165034a0c4` — 1 info
  - api operation id `CommunicationIdentity_Create` removed and replaced with `IdentityOperations_Create`
- **2026-07-13** `52bd93520067` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`

[Change history](https://skmtc.dev/azure/apis/communication-identity/changes/identities/post.md)

---

[API](https://skmtc.dev/azure/apis/communication-identity.md) · [All operations](https://skmtc.dev/azure/apis/communication-identity/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-identity/revisions/6f165034a0c4/schema)