Add a user identity

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://openapi.logto.io/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Logto API references MCP server": {
    "url": "https://openapi.logto.io/mcp"
  }
}
Close
POST /api/my-account/identities
O auth2

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.

application/json

Body Required

  • newIdentifierVerificationRecordId string Required

    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, recent user authentication is required or the access token does not include the identities scope.

  • 403

    Forbidden

  • 422

    The new verification record is invalid or the identity is already in use.

POST /api/my-account/identities 
curl \
 --request POST 'https://[tenant_id].logto.app/api/my-account/identities' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "newIdentifierVerificationRecordId": "string"
}'
Request examples 
{
  "newIdentifierVerificationRecordId": "string"
}