Request access tokens

This endpoint allows requesting an access token following one of the flows below:

  • Authorization Code (exchange code for access token)
  • Refresh Token (exchange refresh token for a new access token)

The table below indicates the required parameters for each specific grant_type options. Empty cells indicate a parameter is ignored for that specific grant type.

Client authentication: Confidential clients should authenticate using HTTP Basic Authentication, where the username is the client_id and password is the client_secret.

Authorization codeRefresh token
grant_typeauthorization_coderefresh_token
coderequired
redirect_urioptional
refresh_tokenrequired
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Form Data
string

Authorization code provided by the /oauth2/authorize endpoint

string
enum
required

Type of grant

Allowed:
string

Required only if the redirect_uri parameter was included in the authorization request /oauth2/authorize; their values MUST be identical.

string

The refresh token that the client wants to exchange for a new access token (refresh_token grant_type)

Headers
string
required

To authenticate your application you need to use HTTP Basic Authentication. Which means you need to base64 encode the following string "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" and add it to the Authorization header.

Responses

429

The rate limit has been exceeded for the plan or operation being used.

500

An error occurred while executing this request. Please try again later and contact support if the error persists.

503

An error occurred while executing this request. Please try again later and contact support if the error persists.

Language
Credentials
Header
URL
LoadingLoading…
Response
Choose an example:
application/json