AuthnAuthzAPI
Get Started
Get Started
  1. OAuth Authentication
  • Overview
  • Registration & Onboarding
    • Register a new user
      POST
    • Verify email address
      POST
    • Resend verification code
      POST
  • Authentication
    • Login user
      POST
    • Logout user
      POST
    • Request a password reset email
      POST
    • Verify password reset token
      POST
    • Update password
      POST
    • Refresh access token
      POST
    • Get current authenticated user
      GET
  • OAuth Authentication
    • OAuth authentication
      GET
    • OAuth callback
      GET
  • Session Management
    • Get all sessions
      GET
    • Revoke session
      DELETE
    • Revoke all sessions
      DELETE
  • Profile Management
    • View profile information
      GET
    • Update profile information
      PATCH
  1. OAuth Authentication

OAuth callback

Developing
GET
/auth/oauth/{provider}/callback
Handles the OAuth provider response after the user successfully authenticates with Google or GitHub. This endpoint validates the authorization response, retrieves the user's profile information from the provider, creates or authenticates the user account, creates a session, and issues application access and refresh tokens.
Per the system requirements, first-time OAuth logins create a new account automatically, OAuth-created accounts are automatically verified, and profile information (name, email, profile picture) is stored in the system.

Request

Path Params

Query Params

Responses

🟢200Success
application/json
Bodyapplication/json

🟠429Rate Limit Exceeded
🔴500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'http://localhost:3000/api/v1/auth/oauth//callback?code=undefined&state=undefined&error=undefined&error_description=undefined'
Response Response Example
200 - Example 1
{}
Modified at 2026-07-18 20:07:25
Previous
OAuth authentication
Next
Get all sessions
Built with