Client credentials allow you to authenticate to the bol.com Retailer API. Client credentials are a kind of username and password for the API. Below are the steps to create client credentials:
1. Log into the bol.com sales account, open the settings page and go to 'API Instellingen’ under the 'Instellingen' heading.
2. Fill in the contact details of your technical contact and click 'Opslaan'.
These contact details are used to inform you of important updates and news surrounding the API. Therefore, be sure to fill in the contact details of the person who is technically responsible for your API connection.
3. Below the header 'Client credentials for the Retailer API', click 'Aanmaken'.
In the text field, enter a name for the credentials. Preferably use a name from your internal or external software. If you use a third party for the API (an integration partner, fulfilment party for example), enter the name of this party. After filling in the name, click ‘Aanmaken’.
4. The Client credentials are now created.
The Client ID is automatically displayed in the screen. When you click ‘Toon secret’, a pop-up containing the Client secret opens.
5. When using an integration partner/third party, enter Client credentials in their system.
If you want to connect with multiple third parties, you need to create separate Client credentials for each party. When you stop working with a third party, you can also easily delete their Client credentials.
Building your own API link? You will find everything about authentication flows and Client credentials here.
Simplified authentication process authorised parties
Some trusted third parties do not require you 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.com account.
For trusted third parties, follow the steps below when setting up a link with bol.com.
1. Go to the third-party website.
When you set up a link to bol.com, you will automatically be redirected to the bol.com login page. Enter the login details of your bol.com sales account and click ‘Inloggen’.
2. After logging in, you will get a follow-up screen where you need to give permission to the party to link your bol.com account.
Click the ‘Toestaan’ button to grant access . You will then be redirected back to the third-party website.
3. In the bol.com sales account, under the heading 'Authorised parties for the Retailer API', you will now find the name of the third party.
Here you can also see when the authorisation expires. The authorisation is valid for one year, after that, you have to authorize again. Fortunately, most authorised parties send a notification before the expiry date to remind you of this.
4. Do you stop using the third party at some point?
You can remove it in your bol.com sales account, below the heading ‘Authorised parties for the Retailer API’.
Any questions?
Chat with the partnerservice.
- Monday till Friday:
- 09.00 - 17.00
