# Setup Guide

This guide will help you set up Sendinblue as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to Sendinblue.

## Connection compatibility

{{< destination-config >}}

{{< info >}}
In the web device mode integration, that is, using [JavaScript SDK]({{< ref "sources/event-streams/sdks/rudderstack-javascript-sdk/_index.md" >}}) as a source, RudderStack loads the Sendinblue native SDK from the `https://sibautomation.com/` domain.

Based on your website's content security policy, you might need to [allowlist this domain]({{< ref "sources/event-streams/sdks/rudderstack-javascript-sdk/load-js-sdk.md#allowlist-destination-domain" >}}) to load the Sendinblue SDK successfully.
{{< /info >}}

## Get started

Once you have confirmed that the source platform supports sending events to Sendinblue, follow these steps:

1. From your [RudderStack dashboard](https://app.rudderstack.com/), add a source. Then, from the list of destinations, select **Sendinblue**.
2. Assign a name and click **Continue**.

## Connection settings

To successfully configure Sendinblue as a destination, you will need to configure the following settings:

- **API Key:** Enter your Sendinblue API key. Refer to the [FAQ]({{< ref "#faq" >}}) section for more information on obtaining the API key.
- **Client Key:** Enter your Sendinblue client key. Refer to the [FAQ]({{< ref "#faq" >}}) section for more information on obtaining the client key.
- **Create contact via Double-opt-in:** This setting is applicable **only** for the cloud mode. You can enable it to [create a contact using the DOI flow](https://developers.sendinblue.com/reference/createdoicontact). If enabled, enter the following settings:
    - **Template ID:** Enter the ID of the Double opt-in (DOI) template. Refer to the [FAQ]({{< ref "#faq" >}}) section for more information on obtaining the DOI template ID.
    - **Redirection URL:** Enter the URL of the web page where the user is redirected after clicking on the verification email.
- **Send user traits in track call:** Enable this setting to send user traits to Sendinblue via the `track` call. RudderStack updates the contact's attributes corresponding to their traits in the `track` call.
- **Map your traits to Sendinblue contact attributes:** Enter the traits in RudderStack's payload to be mapped to the [contact attributes in Sendinblue](https://my.sendinblue.com/lists/add-attributes).

{{< warning >}}
Enter only the key name present in the event's `traits` object.

For example, to map `context.traits.email` to Sendinblue's `EMAIL` attribute, specify `email` in the **Rudder payload trait key** field and `EMAIL` in the **Sendinblue contact attribute name** field.

{{< figure src="images/event-stream-destinations/sendinblue-mapping.webp" alt="Sendinblue trait mapping" >}}
{{< /warning >}}

- **Client-side Events Filtering**: This setting is applicable **only** for the device mode and lets you specify which events should be blocked or allowed to flow through to Sendinblue. For more information on this setting, refer to the [Client-side Events Filtering]({{< ref "sources/event-streams/sdks/event-filtering.md" >}}) guide.

## FAQ 

#### Where can I find the API key?

1. Log in to the [Sendinblue account](https://account-app.sendinblue.com/account/login).
2. Click on your profile and select **SMTP & API**. Here, you can find an existing API key or create a new one by clicking on **CREATE A NEW API KEY**:

{{< image src="images/event-stream-destinations/sendinblue-api-key.webp" alt="Sendinblue API Key" >}}

#### Where can I find the Client Key?

1. Log in to the [Sendinblue account](https://account-app.sendinblue.com/account/login).
2. Click **Automation** tab > **Script set up** under the **Help** section in the left navigation bar.
4. Select **JS Tracker** in the **Choose an installation option** step to obtain the **client_key** from the script:

{{< image src="images/event-stream-destinations/sendinblue-client-key.webp" alt="Sendinblue Client Key" >}}

#### Where can I find the DOI templated ID?

1. Log in to the [Sendinblue account](https://account-app.sendinblue.com/account/login).
2. Click **Templates** in the left navigation bar to obtain your template's ID:

{{< image src="images/event-stream-destinations/sendinblue-doi-template-id.webp" alt="Sendinblue DOI template ID" >}}
