Getting access with API Client credentials
To get access to the API, you need Client credentials. On this page, you'll find more information about Client credentials and how to create them. Some of our gold, silver, and bronze partners are connected to our simplified authentication process. At the bottom of this page, you can read more about how the authentication process works for these third parties.
Creating Client credentials
With Client credentials, you can authenticate yourself with the bol Retailer API. Client credentials are a type of username and password for the API. Below you will find the steps to create Client credentials:
Open API settings
Log in to your bol seller account, open the settings page, and under the heading 'Services', go to 'API Settings'.
Enter the contact details of your technical contact person and click 'Save'.
Under the heading 'Client credentials for the Retailer API', click 'Create'.
The Client credentials have now been created.
Are you using an integration partner? Enter your Client credentials there.
If you are using an integration partner/third party, you will enter the Client credentials in their system.
If you want to connect with multiple third parties, you must create separate Client credentials for each party. If you stop using a third party, you can easily remove their Client credentials.Tip!
With our previous API, Client Credentials were called API Keys. It's possible that your integration partner still refers to 'API Keys' instead of Client credentials. This is not a problem; you can simply enter your Client credentials under API Keys.
Simplified authentication process for authorized parties
With some trusted third parties, you don't need to enter Client credentials in their application or website. You only need to give permission once a year from their application to exchange data with your bol account.
For trusted third parties, follow the steps below when setting up an integration with bol.
Go to the third party's website.
Grant access to third party
After logging in, you will see a subsequent screen where you need to give permission to the party to connect your bol account.
Click the 'Allow' button to grant access. You will then be redirected back to the third party's website.
View authorized parties
In your bol seller account, under the heading 'Authorized parties for the Retailer API', you will now find the name of the third party.
Here you can also see when the permission expires: the permission is valid for one year and must be renewed afterwards. Fortunately, most authorized parties send a notification before the expiry date to remind you.
