Skip to main content
POST
/
oauth
/
token
curl -X POST https://api.cloud.blnkfinance.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
  -d "grant_type=authorization_code" \
  -d "code=THE_CODE_FROM_REDIRECT" \
  -d "redirect_uri=https://your-app.com/oauth/callback"

{
  "access_token": "blnk_at_...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "blnk_rt_...",
  "scope": "data:read data:write proxy:write"
}
Exchange an authorization code for an access token. Use this endpoint after the user authorizes your app and you receive an authorization code.

​
Request structure

curl -X POST https://api.cloud.blnkfinance.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
  -d "grant_type=authorization_code" \
  -d "code=THE_CODE_FROM_REDIRECT" \
  -d "redirect_uri=https://your-app.com/oauth/callback"
​
Authorization
string
required
Basic authentication using your OAuth client ID and client secret. Format: Basic base64(client_id:client_secret) or use -u flag in cURL.
​
grant_type
string
required
Must be authorization_code for this flow.
​
code
string
required
The authorization code received from the OAuth redirect after user authorization.
​
redirect_uri
string
required
The redirect URI that was used in the authorization request. Must match exactly.

​
Response structure

{
  "access_token": "blnk_at_...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "blnk_rt_...",
  "scope": "data:read data:write proxy:write"
}
​
access_token
string
required
The access token to use for authenticating API requests. Include in the Authorization: Bearer <access_token> header.
​
token_type
string
required
Always Bearer for access tokens.
​
expires_in
integer
required
Number of seconds until the access token expires.
​
refresh_token
string
required
Token used to obtain a new access token when the current one expires.
​
scope
string
required
Space-separated list of scopes granted to this token.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.