API-Based Social Login (Mobile)
POST
/auth/social/{provider}/login-api
⚠️ BETA FEATURE - Authenticate using social provider access token or ID token. Designed for mobile apps that handle OAuth flow client-side.
Parameters
Path Parameters
provider*
Typestring
RequiredValid values
"google""github""facebook""apple""discord""microsoft"Request Body
application/json
JSON
{
"idToken": "eyJhbGciOiJSUzI1NiIs..."
}
Responses
Authentication successful
application/json
JSON
{
"success": true,
"user": {
"id": "usr_abc123",
"email": "user@example.com",
"name": "John",
"last_name": "Doe",
"user_name": "johndoe",
"user_type": "customer",
"picture": "https://storage.pubflow.com/users/usr_abc123/picture.jpg",
"phone": "+1234567890",
"is_verified": true,
"two_factor": false,
"created_at": "2025-12-07T10:00:00Z",
"updated_at": "2025-12-07T10:00:00Z"
},
"sessionId": "ses_xyz789",
"expiresAt": "string",
"loginType": "social_auth_api",
"provider": "google"
}