Skip to content
Boekhouden.farshadbashir.nl
Help and manual Online Boekhouden
API-koppelingen
Contents and search

API integrations

Give external software only the required permissions and administrations through a personal token.

An API token is a secret key that allows external software to act through your account. Create a separate token for each integration with the fewest possible permissions, administrations and validity.

Step by step

  1. 1Open My account, choose API and then New API token. Confirm your password when required.
  2. 2Give the token a recognisable name and select an expiry date suited to its use.
  3. 3Select only the read or write permissions and active administrations the integration actually needs.
  4. 4Create the token and immediately copy its secret value to the integration or a password manager. Boekhouden shows the full value only once.
  5. 5Regularly review the expiry date and when the token was last used.
  6. 6Revoke the token immediately when the integration ends or the secret may have become known.

What is on the screen?

  • Name and expiry date
  • Permissions
  • Selected administrations
  • Last used
  • Revoke token

What happens next?

An expired or revoked token stops working immediately. It can never provide more access than your account has at that time. Do not store it in a URL, ordinary email or public source file.

For developers

  • Send the token as Authorization: Bearer <token> and optionally use Accept-Language: nl or en.
  • Use a unique Idempotency-Key for every financial write request. Send amounts as decimal strings and include the current version when editing or deleting.
  • Endpoints are under /api/v1. Download the OpenAPI 3.1 contract below for paths, fields and error structures.
Download the OpenAPI 3.1 contract

Common situations

I see an errorRead the message by the field, correct the value and try again. Other details remain where possible.
I cannot continueCheck that all required fields are complete. If a link no longer works, request a new one.

Continue reading

Security

Change your password and manage two-factor authentication and recovery codes in one place.

Read guidance →

Administrations

View the administrations you own or use and open the correct bookkeeping environment.

Read guidance →

My activity

Review recent sign-in, account and security actions involving your account.

Read guidance →