Skip to main content
GET
Authorize

Query Parameters

string
required
Your app’s client ID. You can find this in your app’s settings pages at build.attio.com.
string
required
The response type. This should always be "code".
string
required
The URL to redirect to after the user authorizes access to your app. This URL must exactly match one of the registered redirect URLs in your app’s settings pages at build.attio.com.
string
A random string to prevent CSRF attacks. Set this when starting the OAuth flow and verify it matches when the user is redirected back to your app.
string
default:"workspace"
The level of the access token, either "workspace" or "user". A "user" token requires code_challenge and code_challenge_method.
string
A PKCE code challenge: the base64url-encoded SHA-256 hash of a code verifier. Required when token_level is "user". Pass the code verifier as code_verifier when you exchange the code at the token endpoint.
string
The PKCE code challenge method. This should always be "S256". Required when code_challenge is set.

Response

Redirect
After the user approves the connection, they are redirected to the redirect_uri with a code query parameter. If provided, the original state is also included.