Skip to main content

POST /v1/oauth/token

Scope

No auth (client authentication)

Request parameters

NameInTypeRequiredDescription
grant_typebodyenum(client_credentialsauthorization_coderefresh_token)
client_idbodystringrequiredThe client ID you were issued.
client_secretbodystringoptionalClient secret (required for confidential clients). Do not call this from a browser.
scopebodystringoptionalRequested scopes, space separated. Omit to receive the client's default scopes.
codebodystringoptionalauthorization_code grant
redirect_uribodystringoptionalFor authorization_code, the exact value used in the authorization request.
code_verifierbodystringoptionalPKCE(authorization_code grant)
refresh_tokenbodystringoptionalrefresh_token grant

Response example

{
"access_token": "string",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "read_items read_users",
"refresh_token": "string"
}

Description

Token endpoint (client_credentials / authorization_code+PKCE / refresh_token)

Error response example

{
"error": {
"code": "invalid_request",
"message": "malformed request",
"request_id": "req_01H..."
}
}

Possible errors: 400 / 401