OAuth authorize endpoint

This endpoint is used to initiate the OAuth authorization flow. there are two purposes for this endpoint: 1. Authenticate a user with an OAuth provider. 2. Link an existing user with an OAuth provider.

GET /auth/oauth/authorize/{provider_id}

OAuth authorize endpoint

cURL

curl --request GET \
  --url https://api.stack-auth.com/api/v1/auth/oauth/authorize/{provider_id}

200

{
  "location": "<string>"
}

Path Parameters

provider_id · string · required

Query Parameters

type · string · default: authenticate

token · string · default: ""

provider_scope · string

error_redirect_uri · string

after_callback_redirect_url · string

stack_response_mode · string · default: redirect

bot_challenge_token · string

bot_challenge_phase · string

bot_challenge_unavailable · string

client_id · string · required

client_secret · string · required

redirect_uri · string · required

scope · string · required

state · string · required

grant_type · string · required

code_challenge · string · required

code_challenge_method · string · required

response_type · string · required

Response

200

application/json

Successful response

location · string · required