v1

latestOpenAPI 3.0.32026-08-064799140.5 KB
Identifiers

Create a login identifier for a user

Creates a new login identifier for a user with the given ID. Login identifiers can be of the type email, phone, or username. Separating login identifiers from users allows Corbado to manage multiple login identifiers of different types for each user.

You can set up login identifiers in the Developer Panel or consult the Documentation for more details.

post/users/{userID}/identifiers

Path parameters

userIDstring required
Example:usr-4693224802260150919

Unique identifier of the user. Format: usr-<number>.

Request body

identifierType'email' | 'phone' | 'username' required
identifierValuestring required
status'pending' | 'primary' | 'verified' required

Response

Identifier has been created.

identifierIDstring required

Unique identifier of the login identifier.

type'email' | 'phone' | 'username' required
valuestring required

Value of the identifier (here email address).

status'pending' | 'primary' | 'verified' required
userIDstring required

Unique identifier of the user.

Example response

{
  "identifierID": "ide-4693224802260150919",
  "value": "jane@doe.com",
  "userID": "usr-4693224802260150919"
}