POST
/
v1
/
initiate
/
otp

This API is accessible exclusively to users subscribed to the OTPless Pro plan. Ensure you have an active OTPless Pro Plan subscription to utilize this feature.

If you need to send the SMS OTP to users outside India then please reach out to us on support to activate it.

Authorizations

clientId
string
headerrequired
clientSecret
string
headerrequired

Body

application/json
phoneNumber
string
required

The phone number to which the OTP will be sent, including country code.

channels
enum<string>[]
required

An array specifying the channels through which the OTP will be sent. Supported channels include WHATSAPP, SMS, VOICE_CALL, and VIBER. If multiple channels are provided, a smart authentication flow is activated, which automatically falls back to the next channel in the array if the OTP delivery fails or if the user does not verify within the expected time frame.

Available options:
WHATSAPP,
SMS,
VOICE_CALL,
VIBER
expiry
integer

The expiration time for the OTP in seconds.

otpLength
enum<integer>

The length of the OTP, either 4 or 6.

Available options:
4,
6
metadata
object

Additional metadata for the request.

Response

200 - application/json
requestId
string

The unique identifier for the OTP request.