Poplar + Iterable Integration

The Poplar + Iterable integration lets you send physical mailers from your Iterable journeys.

# Setup instructions

# Step 1: Create a Poplar API key for Iterable

1. Sign in to Poplar and create a new API key for Iterable.
2. Copy the key.

# Step 2: Create a journey webhook in Iterable

1. In Iterable, navigate to Integrations > Journey webhooks.

2. Click New webhook.

   NOTE

   We strongly recommend using a test API key while configuring and testing your webhook. (There's no way to cancel API requests that are sent to our production environment.)

3. Add a Custom header with the following configuration:

   • Name: Authorization
   • Key: Bearer <YOUR_API_KEY>

   

4. Under Body, add the following form fields (campaign_id should be the Poplar campaign ID). (The last key/value pair is an example of how you can add dynamic data to your mailer.)

   ‌

   NOTE

   The order of the fields you add is important—the request will fail if you mix up the order of the address fields.

When you're finished setting up your webhook, it should look like this:

# Step 3: Add the webhook to a journey in Iterable

1. Navigate to Messaging > Journeys.

2. Open one of your journeys or create a new one.

3. Add a Call webhook tile to the journey, and set it up to call your Poplar journey webhook.

   

4. Click Test journey, and enter your email address. Then, go back in to Poplar and check the History tab of the campaign to find the mailing.

   

We recommend leaving the webhook live with your test API key for a while to get a sense for your volume. Once you're confident that it's working well, go back in and replace your test API key and the campaign ID with the real versions.

# Questions?

Reach out to support@heypoplar.com.