API reference / Authentication
Get an access token
POST
/v1/oauth/tokenNo access token needed — this is the call that gets you one.
Exchanges your application's client_id and client_secret for a short-lived access token, carrying exactly the scopes your application was approved for. Call this first — every other /v1 endpoint needs the token it returns in the Authorization header. A token is valid for 1 hour and there's no refresh token, so just repeat this call once it expires (a 401 with code invalid_token from any other endpoint is your signal to).
Request bodyapplication/jsonrequired
client_idstringrequiredclient_secretstringrequired
Responses
- 200Access token issued
Response fields
access_tokenstringtoken_typestringexpires_inintegerscopestring
- 401Invalid client_id or client_secretExample response
{ "error": { "code": "invalid_client", "message": "Invalid client_id or client_secret." } }
