Headless - MAGIC LINK

​

Prerequisites

1. Make sure you have followed the SDK Setup Guide before starting with this document.
2. Ensure you have admin access to the OTPless Account.

​

Configure Magic Link Auth on Dashboard

1. Log in to the OTPless dashboard with your registered email ID.
2. Go to Configure Channel.
3. Enable the phone or email channel based on your requirement.
4. When you enable the channel, you will see the option to configure the auth method and delivery channel.
5. Choose Magic Link as the auth method.

​

Step 1: Send Magic Link

​

Choose your identity type to verify:

let headlessRequest = {};
headlessRequest = {
    countryCode,
    phone
}
await manager.startHeadless(headlessRequest);

{
  "statusCode": 200,
  "success": true,
  "response": {
    "channel": "PHONE",
    "deliveryChannel": "WHATSAPP",
    "authType": "MAGICLINK",
    "requestId": "xxxxxxxxxxxxxxxx"
  }
}

let headlessRequest = {};
headlessRequest = {
    countryCode,
    phone
}
await manager.startHeadless(headlessRequest);

{
  "statusCode": 200,
  "success": true,
  "response": {
    "channel": "PHONE",
    "deliveryChannel": "WHATSAPP",
    "authType": "MAGICLINK",
    "requestId": "xxxxxxxxxxxxxxxx"
  }
}

let headlessRequest = {};
headlessRequest = {
  email,
};
await manager.startHeadless(headlessRequest);

{
  "statusCode": 200,
  "success": true,
  "response": {
    "channel": "EMAIL",
    "deliveryChannel": "EMAIL",
    "authType": "MAGICLINK",
    "requestId": "xxxxxxxxxxxxxxxx"
  }
}

​

Step 2: Get Auth Token

Awesome! You’ve completed the client-side integration. Now, after the Magic Link is verified, you’ll get a callback with the ONETAP response containing the token. You’ll need to parse the token from the response JSON.

Sample Callback JSON

{
  "responseType": "ONETAP",
  "statusCode": 200,
  "response": {
    "status": "SUCCESS",
    "token": "unique_token_here",
    "userId": "unique_user_id_here",
    "timestamp": "ISO_timestamp_here",
    "identities": [
      {
        "identityType": "MOBILE",
        "identityValue": "919899038845",
        "channel": "MAGIC_LINK",
        "methods": [
          "WHATSAPP"
        ],
        "verified": true,
        "verifiedAt": "2024-08-05T14:01:31Z"
      }
    ],
    "idToken": "jwt_token",
    "network": {
      "ip": "127.0.0.1",
      "timezone": "Asia/Kolkata",
      "ipLocation": {}
    },
    "deviceInfo":{},
    "sessionInfo":{},
    "firebaseInfo":{}
  }
}

​

🏁 Check Point : Verify Auth Token

Once you have retrieved the token, send it to your backend and call the verify token API.