Headless - Social Auth
Welcome to the Social Auth integration guide! Follow these steps to send and verify phone and email using the OTPLESS Headless SDK.
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.
Choose your Programming Language:
Step 1: Initiate Social Auth
To initiate Social Auth for phone number or email verification
Request
Enums for social auth
[
"WHATSAPP",
"GMAIL",
"APPLE",
"LINKEDIN",
"MICROSOFT",
"FACEBOOK",
"SLACK",
"TWITTER",
"DISCORD",
"LINE",
"LINEAR",
"NOTION",
"TWITCH",
"GITHUB",
"BITBUCKET",
"ATLASSIAN",
"GITLAB",
"TRUE_CALLER"
]
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
How to parse the token from response?
🏁 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 →
Was this page helpful?