Start an OAuth authorization request (PKCE)

Start an OAuth 2.0 authorization request with PKCE (S256). The browser is redirected to the login page and ultimately back to the client redirect_uri with a code query parameter.

Start an OAuth authorization request (PKCE)

cURL

curl --request GET \
  --url https://formhug.ai/api/v1/oauth/authorize

400

{
  "error": "invalid_request",
  "error_description": "Unknown client_id"
}

Query Parameters

client_id · string · required

redirect_uri · string · required

Must be on the client whitelist

code_challenge · string · required

PKCE code_challenge (S256)

code_challenge_method · enum<string> · required

Available options: S256

scope · string

Space-separated; defaults to the client default scope

state · string

Response

302

Redirect to the login page or to the client redirect_uri (with error)