API Reference
Start typing to search…

Authentication for Private integrations

To access the Bokio API with a Private Integration, you need to pass an integration token that can be obtained in the Bokio app.

Using Integration token for Company API

To use the Bokio Company API with an Integration token, follow these steps:

Obtaining the Integration token

  1. Log in to the Bokio app.
  2. Navigate to the Integrations page.
    Integrations page
  3. Create integration
    Add integration
  4. Copy the Integration token provided for your company.
    Copy token

Including the Integration token in Requests

To include your Integration token in requests, you need to add an Authorization: Bearer header with the value of your Integration token. The parameter companyid should be sent in with every API request to identify the company and can be obtained from the url when you are in Bokio accounting platform.

GET companies/{companyid}/some-operation HTTP/1.1
Host: api.bokio.se
Authorization: Bearer <your-integration-token>

Make sure to replace <your-integration-token> with your actual Integration token.

Handling Authentication Errors

If you make a request without a valid Integration token or with an expired Integration token, you will receive a 401 Unauthorized response. Make sure to handle this error and prompt the user to provide a valid Integration token.