Headless - Social Auth

Prerequisites

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

Configure OAuth platforms on Dashboard

Log in to the OTPless dashboard with your registered email ID.
Go to Configure Channel.
Enable the channels from list of social Auth.

Important: Don’t forget to save and publish the configuration.

To initiate Social Auth for phone number or email verification Request

let headlessRequest = { channelType: channelType.toUpperCase() };
await manager.startHeadless(headlessRequest);

let headlessRequest = { channelType: "WHATSAPP" };
await manager.startHeadless(headlessRequest);

Enums for social auth

[
  "WHATSAPP",
  "GMAIL",
  "APPLE",
  "LINKEDIN",
  "MICROSOFT",
  "FACEBOOK",
  "SLACK",
  "TWITTER",
  "DISCORD",
  "LINE",
  "LINEAR",
  "NOTION",
  "TWITCH",
  "GITHUB",
  "BITBUCKET",
  "ATLASSIAN",
  "GITLAB",
  "TRUE_CALLER"
]

Response

{
  "statusCode": 200,
  "success": true,
  "response": {
    "channel": "OAuth",
    "channelType": "WHATSAPP",
    "requestId": "xxxxxxxxxxxxxxxx"
  }
}

{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
  "statusCode": {
    "type": "integer"
  },
  "success": {
    "type": "boolean"
  },
  "response": {
    "type": "object",
    "properties": {
      "channel": {
        "type": "string",
        "enum": ["OAuth"]
      },
      "channelType": {
        "type": "string",
        "enum": [
          "WHATSAPP",
          "GMAIL",
          "APPLE",
          "LINKEDIN",
          "MICROSOFT",
          "FACEBOOK",
          "SLACK",
          "TWITTER",
          "DISCORD",
          "LINE",
          "LINEAR",
          "NOTION",
          "TWITCH",
          "GITHUB",
          "BITBUCKET",
          "ATLASSIAN",
          "GITLAB",
          "TRUE_CALLER"
        ]
      },
      "requestId": {
        "type": "string"
      }
    },
    "required": ["channel", "channelType", "requestId"]
  }
},
"required": ["statusCode", "success", "response"]
}

Step 2: Get Auth Token

Awesome! You’ve completed the client-side integration. Now, after the User identity is verified with social platform, 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": "WHATSAPP",
        "methods": [
          "WHATSAPP"
        ],
        "name": "Satyam Nathani",
        "verified": true,
        "verifiedAt": "2024-08-05T14:02:57Z"
      }
    ],
    "idToken": "jwt_token",
    "network": {
      "ip": "127.0.0.1",
      "timezone": "Asia/Kolkata",
      "ipLocation": {}
    },
    "deviceInfo":{},
    "sessionInfo":{},
    "firebaseInfo":{}
  }
}

You can view a complete sample response here

🏁 Check Point : Verify Auth Token

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

Web SDKs

Native/Mobile SDKs

References

Headless - Social Auth

Prerequisites

Configure OAuth platforms on Dashboard

Step 2: Get Auth Token

🏁 Check Point : Verify Auth Token

​Prerequisites

​Configure OAuth platforms on Dashboard

​Step 1: Initiate Social Auth

​Step 2: Get Auth Token

​🏁 Check Point : Verify Auth Token

Prerequisites

Configure OAuth platforms on Dashboard

Step 1: Initiate Social Auth

Step 2: Get Auth Token

🏁 Check Point : Verify Auth Token