# Link social identity to user

**POST /api/users/{userId}/identities**

Link authenticated user identity from a social platform to a Logto user.

The usage of this API is usually coupled with `POST /connectors/:connectorId/authorization-uri`. With the help of these pair of APIs, you can implement a user profile page with the link social account feature in your application.

Note: Currently due to technical limitations, this API does not support the following connectors that rely on Logto interaction session: `@logto/connector-apple`, `@logto/connector-saml`, `@logto/connector-oidc` and `@logto/connector-oauth`.


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


## Authentication methods
- O auth2


## Parameters

### Path parameters
- **userId** (string)
  The unique identifier of the user.


### Body: application/json (object)

- **connectorId** (string)
  The Logto connector ID.
- **connectorData** (object)
  A json object constructed from the url query params returned by the social platform. Typically it contains `code`, `state` and `redirectUri` fields.


## Responses
### 200
A new identity is linked to the user.

#### Body: application/json (object)
- ***** (object)


### 400
Bad Request

### 401
Unauthorized

### 403
Forbidden

### 404
Not Found

### 422
Unprocessable Content


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