# How to connect to bol.com

To connect your bol.com account, you will need to generate API credentials (Client ID and Client Secret) from the bol.com Seller Dashboard (SDD). This guide will walk you through the Client Credentials Flow.

## Prerequisites

- A bol.com seller account.
- Access to the Seller Dashboard (SDD).

## Step 1: Acquiring API credentials

The Seller Dashboard may show its labels in English or in Dutch. This guide gives both.

1.  **Log in to the Seller Dashboard (SDD)**.
    You can access the portal via [https://login.bol.com/](https://login.bol.com/)

2.  **Navigate to API Settings**.
    Once logged in, open your account profile and click **Settings** (Instellingen). In the navigation pane, find and click **Services** (Diensten), then select **API Settings** (API Instellingen).

3.  **Provide Technical Contact Details**.
    Before creating credentials, you'll need to provide details for a technical contact. This information is used by bol.com Partner Service to contact you regarding your API usage. Ensure this information is accurate and kept up to date, and that this contact stays reachable, as bol.com may block API access if it cannot reach them.

![Provide technical contact details](https://res.cloudinary.com/apideck/image/upload/v1690189281/docs/connectors/bol-com/y2tnfkv98fmmqyhsvpic)


4.  **Create API Credentials for the Retailer API**.

    After saving the technical contact information, you will see sections for creating API credentials.

    a.  Navigate to the **Client credentials for the Retailer API** (Client credentials voor de Retailer API) section and click **Create** (Aanmaken).

    ![bol.com Client credentials voor de Retailer API section](https://res.cloudinary.com/apideck/image/upload/v1748334808/docs/connectors/bol-com/sdd-create-credentials-retailer.png)

    b.  A dialog will open. In the text field, provide a descriptive **name** for your credentials (e.g., the name of your application or integration). This helps you identify the credentials later.


    c.  Click **Create** (Aanmaken) to generate the credentials.

    ![Dialog for naming bol.com Retailer API credentials](https://res.cloudinary.com/apideck/image/upload/v1748258752/docs/connectors/bol-com/sdd-create-client.png)
    
    d.  The newly created credentials (Client ID) will appear in the list. To view the Client Secret, click the **Show secret** (Toon secret) link below the Client ID. A dialog box containing the **Client Secret** will open.

    ![bol.com Client Secret dialog](https://res.cloudinary.com/apideck/image/upload/v1748258753/docs/connectors/bol-com/sdd-get-secret.png)

    You will now have your **Client ID** and **Client Secret**.

    **Important:** Store your Client ID and Client Secret securely.

## Step 2: Vault Connection Setup

Now that you have your Client ID and Client Secret, you can set up the connection in Apideck Vault.

1.  **Open Apideck Vault** and navigate to the bol.com connector.
2.  You will be prompted to enter your API credentials.
3.  Paste your **Client ID** into the designated field.
4.  Paste your **Client Secret** into the designated field.
5.  Click **Save** as described in the image below


    ![Apideck Vault bol.com Connection](https://res.cloudinary.com/apideck/image/upload/v1748272350/docs/connectors/bol-com/Screenshot_2025-05-26_at_8.22.03_PM.png)


6. You will see a button to **Authorize** now. If the credentials are correct, Vault will validate the connection and display a success message.


    ![Apideck Vault bol.com Connection Authorize](https://res.cloudinary.com/apideck/image/upload/v1748272368/docs/connectors/bol-com/Screenshot_2025-05-26_at_8.22.12_PM.png)

7. Once it is successfully authorized, you will see **Connected** in green.

    ![Apideck Vault bol.com Connection Successful](https://res.cloudinary.com/apideck/image/upload/v1748272370/docs/connectors/bol-com/Screenshot_2025-05-26_at_8.22.20_PM.png)


Your bol.com account is now connected.

## Important Notes:

*   **One connection per seller account**: The credentials identify a single bol.com seller account. If you have several seller accounts, create credentials in each one and make a separate connection for each.
*   **Token Management**: Apideck uses your Client ID and Client Secret to request and reuse access tokens from bol.com, so you never need to manage tokens yourself.
*   **Credential Security**:
    *   Never share your Client ID and Client Secret.
    *   Create separate credentials for different applications or purposes. If you suspect a credential has been compromised, revoke it from the bol.com Seller Dashboard and create a new one.

For more detailed information, refer to the official bol.com documentation: [Getting access with API client credentials](https://partnerplatform.bol.com/en/idp/getting-access-with-api-client-credentials) and [bol.com Authentication Documentation](https://api.bol.com/retailer/public/Retailer-API/authentication.html).