> ## Documentation Index
> Fetch the complete documentation index at: https://help.smile.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Dotdigital integration setup

> Setup instructions for installing and configuring the Smile and Dotdigital integration.

## Install the Dotdigital integration

To install and configure the Smile and Dotdigital integration:

1. In Dotdigital, [create a new API user](https://support.dotdigital.com/en/articles/8199489-create-an-api-user).
   * For the **Description**, enter `Smile.io`.
   * For **Rate limiting**, select `Tiered`.
2. In **Smile Admin**, install the [Dotdigital integration](https://app.smile.io/integrations/dotmailer)/.
3. Follow the instructions to connect the integration to Dotdigital using the API user you just created.
4. Once connected, on the Dotdigital integration [settings page](https://app.smile.io/integrations/dotmailer), select the address book you want to sync your rewards program information to, and click **Sync address book**.

<Note>
  **Note:** The first data sync can take anywhere from a few minutes to a couple of hours, and only needs to happen once. The exact duration will depend on the number of customers in  your Smile account.
</Note>

## Data syncing

Here's what to expect with how data is synced from Smile to Dotdigital:

* Customers in Smile are matched to Dotdigital contacts by email address, and synced to the address book you selected.
* If a customer already exists in Dotdigital with the same email address, their data will be updated with the latest information from Smile.
* If a customer does not exist in Dotdigital with the same email address, a new contact will be created with the information from Smile.

## Data fields

Once installed and connected, Smile will sync the following data fields in Dotdigital for each customer in the address book you selected.

| Data field name        | Data type | Description                                                                                     |
| ---------------------- | --------- | ----------------------------------------------------------------------------------------------- |
| `SMILE_POINTS_BALANCE` | Number    | The customer's current points balance.                                                          |
| `SMILE_REFERRAL_URL`   | String    | The customer's unique referral URL. Used to share with friends as part of the referral program. |
| `SMILE_VIP_TIER_ID`    | Number    | The ID of the customer's current VIP tier.                                                      |
| `SMILE_VIP_TIER_NAME`  | String    | The name of the customer's current VIP tier.                                                    |
| `SMILE_STATE`          | String    | The customer's state (`member`, `candidate`, or `disabled`).                                    |

You can use these data fields in your email templates to display an individual's loyalty program information, or use it to segment your audience for targetted email sending.