Skip to main content
GET
Redirects the user’s browser to authenticate and grant permissions. On success, issues a one-time Authorization Code to the registered redirect_uri.

Query parameters

string
required
Unique client identifier issued during app registration.
string
required
Callback URL to receive the Authorization Code. Must exactly match the URI registered with the OAuth client.
string
required
Must be fixed value code.
string
Recommended. Random unique string for CSRF protection. Returned as-is in the redirect callback.
string
PKCE code challenge (43–128 chars). Required if code_challenge_method is provided.
string
PKCE method (plain or S256). Required if code_challenge is provided.

Response

On success, the user’s browser is redirected to the redirect_uri with the Authorization Code. On error, the browser is redirected to an error page.
string
One-time Authorization Code. Pass this to POST /oauth/token to obtain tokens.
string
Echoed back from the request. Use this to verify the response integrity.