Authorize

Starts the Authorization Code grant at the authorization endpoint. Redirect the User's browser to this endpoint. The User signs in, then approves or denies the request.

Proof then redirects to your redirect_uri per response_mode, carrying code and state on approval or error and error_description on denial. Exchange the code at POST /oauth/v2/token within 10 minutes.

An unknown client_id or an unregistered redirect_uri sends the User to a Proof-hosted error page. Redirected errors use invalid_scope, invalid_target, access_denied and invalid_request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Your client_id.

string
required

A redirect URI registered on your OAuth application. Receives the authorization response.

string
enum
required
Allowed:
string
required

Space-separated scope values requested from the User. GET /.well-known/oauth-authorization-server lists the supported scopes.

string

An opaque state value, returned unchanged on the redirect.

string
enum

The response mode for the authorization response. Defaults to query. form_post returns an auto-submitting HTML form.

Allowed:
string
string
enum

How code_challenge was derived. Required alongside code_challenge.

Allowed:
Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*