POST
/
auth
/
v1
/
initiate
/
magiclink

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 MAGIC LINK 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
redirectURI
string
required

The URL to which the user will be redirected after successful authentication.

phoneNumber
string
required

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

channels
enum<string>[]
required

An array specifying the channels through which the Magic Link will be sent. Supported channels include WHATSAPP, SMS, 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 delivery of the Magic Link fails or if the user does not verify within the expected time frame.

Available options:
WHATSAPP,
SMS,
VIBER
expiry
integer

The expiration time for the Magic Link in seconds.

metadata
object

Additional metadata for the request.

Response

200 - application/json
requestId
string

The unique identifier for the Magic Link request.