---
title: "Add a user identity"
method: POST
path: "/api/my-account/identities"
tags: ["My account"]
---

# Add a user identity

`POST /api/my-account/identities`

Add an identity (social identity) to the user. A logto-verification-id header is required when the user has at least one security verification method: password, primary email, or primary phone. The header can be omitted only when the user has none of these methods. A verification record for the new social identity is always required.

## Request body

- object
  - `newIdentifierVerificationRecordId` string, required — The identifier verification record ID for the new social identity ownership verification.

## Response `204`

The identity was added successfully.

## Other responses

- `400` — The request body is invalid or the social identity field is not editable.
- `401` — Permission denied, identity verification is required or insufficient scope.
- `403` — Forbidden
- `422` — The new verification record is invalid or the identity is already in use.

---

[API](https://skmtc.net/logto/apis/logto-api-references.md) · [All operations](https://skmtc.net/logto/apis/logto-api-references/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/logto/logto-api-references/revisions/0287c6a59eba/schema)