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


## Servers
- Logto endpoint address.: https://[tenant_id].logto.app (Logto endpoint address.)


## Authentication methods
- O auth2


## Parameters



### Body: application/json (object)

- **newIdentifierVerificationRecordId** (string)
  The identifier verification record ID for the new social identity ownership verification.



## Responses
### 204
The identity was added successfully.

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


[Powered by Bump.sh](https://bump.sh)