Social Login Integration - LearnWay Backend

LearnWay supports frictionless onboarding through Google and Apple OAuth providers on both mobile (Flutter/iOS/Android) and web.

1. Client-Side Flow

The client invokes Google Sign-In or Apple Sign-In SDK.
The provider returns an identity payload / token (idToken or user details).
The client submits the credentials to /api/v2/auth/login-with-social.

2. API Endpoint

POST /api/v2/auth/login-with-social
Content-Type: application/json

{
  "email": "student@example.com",
  "provider": "google",
  "country": "US",
  "referralCode": "OPTIONAL_REF"
}

Supported Providers

google
apple

3. Server Behavior

If the user with the given email does not exist, a new user profile is created automatically, setting isEmailVerified: true and assigning standard onboarding XP.
If the user already exists, the system issues a fresh JWT pair (accessToken and refreshToken).