startMfaPhoneNumberRegistration

client.startMfaPhoneNumberRegistration({
  accessToken: string,
  phoneNumber: string, (1)
  trustDevice: boolean, (2)
  action: string
})
1 If the user already has a verified phone number as an identifier in their account, there’s no need to pass the phoneNumber parameter.
2 If the phone number is already verified and you set trust_device to true, the __Host-trusted-device-id cookie is deposited in the response header and you do not need to pass trust_device in the verifyMfaPhoneNumberRegistration step.
If an existing phone number is unverified, it becomes automatically verified with the verifyMfaPhoneNumberRegistration step.

About this command

Starts the MFA phone number registration flow. When started, an SMS is sent to the user for verification.

Examples

client.startMfaPhoneNumberRegistration({
    accessToken: 'eyJ0eXAiOiJKV1QiL...',
    phoneNumber: '+33606060606',
    action: 'stepup'
  })

Parameters

accessToken string

The authorization credential JSON Web Token (JWT) used to access the ReachFive API, less than five minutes old.

phoneNumber string

The user’s phone number.

Both the international format and the national conventions of the account’s country are accepted if configured in account settings.

trustDevice boolean

Boolean indicating if the device should be trusted or not.

Defaults to false.

action string

A string describing the action for the MFA flow.

You can value this with whatever you like. It should match the value you describe in your MFA templates.

We recommend using meaningful values like login or transaction to help better align with MFA email and SMS templates.

Response

Type: Promise<void>