loading
Preparing LoginRadius developer resources
Mission: Help enterprises accelerate digital transformation with our fully-managed Customer IAM technology.
Skip to main content
⚠️You are viewing the legacy API reference. For the latest documentation, please visit the Latest API Reference
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Overview

LoginRadius One-Touch Login offers a modern, passwordless authentication flow where users can register and/or log in without entering a password. Instead, authentication is completed via a verification link sent to the user's email or a one-time passcode (OTP) sent to their phone.

This method is highly user-friendly and especially effective for applications that require fast, frictionless authentication, such as Smart TVs, mobile apps, and IoT devices.

Note: Refer to our Advanced JS Customizations guide if you're using LoginRadiusV2.js to implement One-Touch Login.

Key Capabilities

  • Passwordless Registration & Login: Users can sign up and authenticate using email or phone.

  • OTP or Email Verification Support: Supports email links and SMS-based OTP for flexible flows.

  • No Pre-Existing Account Required: Enables login or registration even if the user doesn't exist in the system.

  • Real-Time Status Polling: Use the One-Touch Login Ping API to track login attempt status via GUID.

  • Frictionless UX: Reduces user entry barriers, improving engagement and accessibility.

LoginRadius API Usage for One-Touch Login

1. One-Touch Login by Email

  • Initiate login using the One-Touch Login by Email API.

  • Generate a unique GUID to track the login attempt.

  • Begin polling using the One-Touch Login Ping API with the GUID.

    • The Ping API will return error code 1139 until the user clicks the email link.
  • A verification email containing a link with a token is triggered.

  • The One-Touch Email Verification API verifies the token when the user clicks the login link.

  • If verified, the login status associated with the GUID is updated.

  • The next Ping detects the verification, and the user is logged in.

2. One-Touch Login by Phone

  • Initiate login using the One-Touch Login by Phone API.

  • The API sends a one-time passcode (OTP) via SMS.

  • The user enters the OTP.

  • The One-Touch Verify OTP API is used to verify the OTP token.

  • On success, the user is authenticated and logged in.

Note: This flow is similar to Passwordless Login by Phone, but includes registration + login support in one step.