Skip to main content
POST
Form-encoded (application/x-www-form-urlencoded). Authenticate the client with HTTP Basic (client_id:client_secret) or with client_id and client_secret in the body, but not both. See Authentication.
string
required
client_credentials for a new token, or refresh_token to refresh one.
string
Space-separated scopes, to get a token that can do less than its client. Leave it out for all of the client’s scopes.
string
With grant_type=refresh_token: the rt_… token from your last token response. Each refresh returns a new one; reusing an old one revokes the whole chain.
string
Your client ID, if you’re not using HTTP Basic.
string
Your client secret, if you’re not using HTTP Basic.

Response

string
at_test_… or at_live_…. Send as Authorization: Bearer ….
string
Bearer.
integer
Seconds until the access token expires: 900.
string
rt_test_… or rt_live_…, valid for 30 days.
string
The scopes the token carries, space-separated.

Errors

Errors follow OAuth 2 ({"error": "invalid_client"}), not the API’s error format.