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

# Poplar

> Keep your Poplar audiences and Do Not Mail list up-to-date and trigger campaigns with data from your warehouse

## Supported syncing

| Type | Description | Supported Sync Modes |
| - | - | - |
| **Segment** | Add members to existing Poplar segments | Add |
| **Campaign Trigger** | Trigger mail campaigns with context from your records | Add |
| **Suppression Lists** | Add members to Poplar's Do Not Mail list | Add |

For more information about sync modes, refer to the [sync modes](https://docs.hightouch.com/syncs/types-and-modes.md#sync-modes) docs.

## Connect to Poplar

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination**
button. Select **Poplar** and click **Continue**. You can then authenticate Hightouch to **Poplar** by entering a Poplar **API key**.

To access your API keys, navigate to **Integrations** > **API** in Poplar. If you want to create a new one, click **Generate Access Token**.

![Finding an API key in the Poplar dashboard](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-poplar-api-key.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=bae93defc9c1031096550dbec2918d44)

We recommend using a **Production** mode API key. If you use a **Test** mode API key, you can only use the Campaign Trigger sync type due to Poplar API limitations. To learn more about Poplar API keys, check out [Poplar's docs](https://docs.heypoplar.com/article/246-test-production-tokens).

## Sync configuration

Once you've set up your Poplar destination and have a [model](https://docs.hightouch.com/getting-started/concepts.md#models) to pull
data from, you can set up your sync configuration to begin syncing data. Go to the [**Syncs** overview
page](https://app.hightouch.com/syncs?from=docs) and click the **Add sync** button to begin. Then, select the relevant model and
the Poplar destination you want to sync to.

### Segment

Hightouch supports adding customer records based on rows from your model to any of your Poplar audiences.

#### Record matching

You can match rows from your model to customer records in Poplar on the fields:

* **Identifier**
* **Email**
* **Hashed Email**
* **Address**

### Campaign trigger

Hightouch lets you use records from your models to trigger mail campaigns. This sync triggers a campaign for your Poplar customers based on the recipient's information.

Once configured, your Hightouch sync triggers your campaign once rows appear in your model. Hightouch triggers your campaign for every row in your model the first time you run the sync, whenever you do a full resync, and for every new row added to your query results in subsequent syncs.

#### Creative selection

You can optionally provide a Poplar **creative ID** for the campaign you want to trigger. If you don't enter a creative ID, Poplar uses the default creative. If you haven't sent a default creative, Poplar alternates between all active creatives.

#### Field mapping

You can sync columns from your source to the following native columns in a Poplar campaign trigger:

* **Email**
* **Company**
* **First Name**
* **Last Name**
* **Address 1**
* **Address 2**
* **City**
* **State**
* **Postal Code**
* **Identifier**
* **Address**

You can also map model columns to use in [Poplar merge tags](https://docs.heypoplar.com/article/203-merge-tags).

> [!WARNING]
>
> This destination doesn't check for duplicates. Hightouch recommends that you set [suppression control](https://docs.heypoplar.com/article/204-suppression-settings) in Poplar to prevent duplicate campaign messages in case your model has duplicates.

#### Testing

You can test your campaign trigger sync by following these steps:

1. Use a **Test** mode API key within your destination configuration.
2. Set up your campaign trigger sync and run it on Hightouch.
3. Download mailing data by navigating to **Integrations** > **Mailing Data** in Poplar.

![Download Poplar mailing data](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-poplar-mailing-data.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=380ac36a88fdff8796c74daa05b8142e)

4. Verify that the trigger was set off by comparing the synced records with mailing data.

> [!NOTE]
>
> If you need to make corrections and thus want to re-run the sync, click **Resync full query** next to the **Run** button.

### Suppression lists

Hightouch supports syncing rows from your model to customer records in your Poplar **Do Not Mail** list. Members of this list are automatically suppressed across all campaigns.

#### Field mapping

You can add customer records to the Poplar' **Do Not Mail** using these fields:

* **Identifier**
* **Email**
* **Hashed Email**
* **Address**

You can select one or more of the identifiers for a single record.

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).