Login end user
POST/auth/users/login
Login end user with email and password. Accepts optional custom_claims to embed in JWT (max 4KB). If MFA is enabled for the user, returns mfa_required: true with a challenge token. The user must then call POST /v1/auth/mfa/verify with the challenge token and TOTP code.
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 500
Login successful or MFA required
Validation error, or organization_id was sent for a user with MFA enabled (mfa_organization_combo_not_supported): log in without it, complete MFA, then switch organization
Invalid email or password
MAU quota exceeded (mau_quota_exceeded): the sign-in would add a new monthly active user to an account already at its MAU limit; the body includes limit and current
Account locked (account_locked); the user is not a member of the requested organization_id (not_a_member_of_organization); or session_limit_exceeded: the user is at max_concurrent_sessions and the application refuses new sessions (deny_new); the body includes max_sessions and current_sessions
Internal server error