OAuth Token Refresh
Access tokens are only valid for a given period of time (typically one hour) for security reasons. Whenever acquiring an new access token its TTL is also given (see expires_in), along with a refresh token that can be used to acquire a new access token after the current one has expired.
Request Body
application/json
When refreshing an existing token use refresh_token.
"refresh_token"The token provided when you got the expired access token.
The client ID for your API app. Required for new API apps. To enhance security, we recommend making it required for existing apps in your app settings.
The client secret for your API app. Required for new API apps. To enhance security, we recommend making it required for existing apps in your app settings.
Response Body
application/json
application/json
curl -X POST "https://example.com/oauth/token?refresh=" \ -H "Content-Type: application/json" \ -d '{ "grant_type": "refresh_token", "refresh_token": "hNTI2MTFmM2VmZDQxZTZjOWRmZmFjZmVmMGMyNGFjMzI2MGI5YzgzNmE3" }'{ "access_token": "MDZhYzBlMGI1YzQ0ZjI1ZjYzYmUyNmMzZWQ5ZGNmOGYyNmQxMmMyMmQ2NmNiY2M3NW=", "expires_in": 86400, "refresh_token": "hNTI2MTFmM2VmZDQxZTZjOWRmZmFjZmVmMGMyNGFjMzI2MGI5YzgzNmE3", "token_type": "Bearer"}OAuth Token Generate POST
Once you have retrieved the code from the user callback, you will need to exchange it for an access token via a backend call.
Create Report POST
Request the creation of one or more report(s). When the report(s) have been generated, you will receive an email (one per requested report type) containing a link to download the report as a CSV file. The requested date range may be up to 12 months in duration, and `start_date` must not be more than 10 years in the past.