My account

Add a user identity

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.

post/api/my-account/identities

Request

  • Base URL: https://[tenant_id].logto.app
  • URL: https://[tenant_id].logto.app/api/my-account/identities
  • Auth: OAuth 2 (client credentials, token URL /oidc/token, scopes: all)

Request body

newIdentifierVerificationRecordIdstring required

The identifier verification record ID for the new social identity ownership verification.

Response

The identity was added successfully.

Changes

No recorded changes to this operation across all 8 revisions of this API.