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, identity verification is required or insufficient 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"
}