Obtaining an Access Token

To obtain an access token, a POST request with the client authentication details is needed. The client’s authentication details can be provided in one of two ways.

Option 1: Use basic authentication

Using an Authentication Header, encode your client id and secret for Basic Authentication, where:

Username: client_id
Password: client_secret

📘
Option 1 is the preferred method.

Option 2: Send authentication details as URL encoded form data

Alternatively you can include the client id and secret as extra values as url encoded form data.

Response

Parameter	Type	Description
access_token Always Present	String	The OAuth token to use for further API calls.
token_type Always Present	String	Type of access token. Will always be Bearer.
expires_in Always Present	Number	The number of seconds left that access_token is valid.
refresh_token Always Present	String	A long-lived token which can be used to obtain a new access token.
as:client_id Always Present	String	your client id.
.issued Always Present	Date	Date and time the access token was issued.
.expires Always Present	Date	Date and time the access token will expire.