authorization

Obtain access token

OAuth 2.0 token endpoint to exchange authorization code for access token, request token with client credentials, or refresh an existing token.

  • Use Authorization Code grant to obtain access token for a Company to use with the Company API.
  • Use Refresh Token grant to obtain a new access token using a refresh token.
  • Use Client Credentials grant without a scope to obtain a legacy General API token.
  • Approved integrations may request Agency API scopes with Client Credentials for machine-to-machine agency access. This requires the integration to hold an approved agency API client-credentials privilege at the integration level.
post/token

Request

  • Base URL
    https://api.bokio.se/v1
  • URL
    https://api.bokio.se/v1/token
  • Auth
    HTTP basic

Request body application/x-www-form-urlencoded

OR
OR

Response

OK

tenant_idstring uuid

The id for the tenant that for this token. This field will be empty when the tenant_type is general

tenant_type'general' | 'company'

The type of tenant that for this token.

access_tokenstring
token_typestring
expires_ininteger
refresh_tokenstring

Returned for authorization_code and refresh_token grant types. The client_credentials grant expected that refresh are done by making another /token request with client_credentials grant.

connection_idstring uuid

The id for the connection that for this token. This field will be empty when the tenant_type is general

Changes

No recorded changes to this operation across all 1 revision of this API.