LoginPasswordlessSmsOtp

Describes all the properties and methods available to customize the Universal Login LoginPasswordlessSmsOtp screen.

The LoginPasswordlessSmsOtp class implements the login-passwordless-sms-otp screen functionality. This screen collects the user’s phone number and code.

Constructors

Create an instance of LoginPasswordlessSmsOtp screen manager:

Example

import LoginPasswordlessSmsOtp from '@auth0/auth0-acul-js/login-passwordless-sms-otp';
const loginPasswordlessSmsOtpManager = new LoginPasswordlessSmsOtp();
loginPasswordlessSmsOtpManager.submitOTP({
  code: '123456',
});

Properties

branding · BrandingMembers

Provides branding-related configurations, such as branding theme and settings.

client · ClientMembers

Provides client-related configurations, such as id, name, and logoUrl, for the login-passwordless-sms-otp screen.

organization · OrganizationMembers

Provides information about the user’s Organization, such as id and name.

prompt · PromptMembers

Contains data about the current prompt in the authentication flow.

screen · ScreenMembersOnLoginPasswordlessSmsOtp

Contains details specific to the login-passwordless-sms-otp screen, including its configuration and context.

tenant · TenantMembers

Contains data related to the tenant, such as id and associated metadata.

transaction · TransactionMembersOnLoginPasswordlessSmsOtp

Provides transaction-specific data for the login-passwordless-sms-otp screen, such as active identifiers and flow states.

untrustedData · UntrustedDataMembers

Handles untrusted data passed to the SDK, such as user input during login.

user · UserMembers

Details of the active user, including username, email, and roles.

Methods

changeLanguage · Promise<void>

This method changes the display language of the Universal Login page.

Example

import LoginPasswordlessSmsOtp from '@auth0/auth0-acul-js/login-passwordless-sms-otp';
const loginPasswordlessSmsOtpManager = new LoginPasswordlessSmsOtp();
loginPasswordlessSmsOtpManager.changeLanguage({
  language: 'fr',
});

Method Parameters

Show Parameters

options · LanguageChangeOptions

language · string · required

The locale code for the desired language (for example, 'en', 'fr', 'es').

persist? · "session"

When set to 'session', the selected language persists for the duration of the session.

[`key`: `string`] · "string" | "number" | "boolean" | "undefined"

Additional custom fields prefixed with ulp- (for example, 'ulp-custom-field').

---

getErrors · Error []

This method retrieves the array of transaction errors from the context, or an empty array if none exist. An array of error objects from the transaction context.

resendManager · ResendControl

This method provides resend functionality with timeout management. It returns a ResendControl object with a startResend() method that triggers the resend and enforces a cooldown period before the user can resend again.

Example

import LoginPasswordlessSmsOtp from '@auth0/auth0-acul-js/login-passwordless-sms-otp';

const loginPasswordlessSmsOtpManager = new LoginPasswordlessSmsOtp();
const { startResend } = loginPasswordlessSmsOtpManager.resendManager({
  timeoutSeconds: 15,
  onStatusChange: (remainingSeconds, isDisabled) => {
    console.log(`Resend available in ${remainingSeconds}s, disabled: ${isDisabled}`);
  },
  onTimeout: () => {
    console.log('Resend is now available');
  }
});

// Call startResend when user clicks resend button
startResend();

Method Parameters

Show Parameters

options · StartResendOptions

timeoutSeconds? · number

The cooldown duration in seconds before the user can resend the code again.

onStatusChange? · OnStatusChangeCallback

Callback invoked whenever the resend status changes, it returns the remaining seconds and if the resend functionality is currently disabled.

onTimeout? · () => void

Callback invoked when the cooldown expires and resend becomes available again.

---

resendOTP · Promise<void>

This method resends the code to the user’s phone number.

Example

import LoginPasswordlessSmsOtp from '@auth0/auth0-acul-js/login-passwordless-sms-otp';
const loginPasswordlessSmsOtpManager = new LoginPasswordlessSmsOtp();
loginPasswordlessSmsOtpManager.resendOTP();

Method Parameters

Show Parameters

options · CustomOptions

[`key`: `string`] · "string" | "number" | "boolean" | "undefined"

Additional data collected from the user.

---

submitOTP · Promise<void>

This method continues the login process using the OTP code.

Example

import LoginPasswordlessSmsOtp from '@auth0/auth0-acul-js/login-passwordless-sms-otp';
const loginPasswordlessSmsOtpManager = new LoginPasswordlessSmsOtp();
loginPasswordlessSmsOtpManager.submitOTP({
  code: '123456',
});

Method Parameters

Show Parameters

options · SubmitOTPOptions

code · string · required

The code entered by the user.

captcha? · string

The captcha code or response from the captcha provider. This property is required if your Auth0 tenant has Bot Detection enabled.

username? · string

The user’s identifier.

[`key`: `string`] · "string" | "number" | "boolean" | "undefined"

Additional data collected from the user.

---

switchConnection · Promise<void>

This method switches between a database connection (password) and a passwordless connection (Email/SMS OTP).

Example

import LoginPasswordlessSmsOtp from '@auth0/auth0-acul-js/login-passwordless-sms-otp';
const loginPasswordlessSmsOtpManager = new LoginPasswordlessSmsOtp();
loginPasswordlessSmsOtpManager.switchConnection({
  connection: 'sms',
});

Method Parameters

Show Parameters

options · SwitchConnectionOptionsSmsOtp

connection · string · required

The connection name to switch to. Use 'email' or 'sms' for passwordless, or a DB connection name for password-based authentication.

[`key`: `string`] · "string" | "boolean" | "number" | "undefined"

Additional data collected from the user.