OAuth Callback Handler
GET
/auth/social/{provider}/callback
⚠️ BETA FEATURE - Handle OAuth callback from social provider. This endpoint is called automatically by the OAuth provider after user authentication.
Parameters
Path Parameters
provider*
Typestring
RequiredValid values
"google""github""facebook""apple""discord""microsoft"Query Parameters
code*
Authorization code from OAuth provider
Typestring
Requiredformat
Response format (json for API clients, omit for web redirect)
Typestring
Valid values
"json"Responses
Authentication successful (API format)
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",
"provider": "google"
}