Integrate with Iterable
Updated over a week ago

You can integrate your account directly with Iterable. An integration between and Iterable does three things:

  1. Automatically sends contacts acquired in your account to Iterable into a list of your choosing.

  2. Automatically suppresses existing contacts in your Iterable account.

  3. Ability to set up custom filters to sync filters (ie, send leads from different domains to different lists or ESPs).

What you'll need

1. Your API Key. Click Integrations > Create API key.

2. Name the API key in the text box. In the Type drop-down, select Server-side. Then, click Create.

3. Click Copy API Key.

4. We also recommend you create the list name you’d like to sync your contacts in Iterable with before finalizing the integration. You can do that by clicking Audience > Lists. Then, Import List.

To get started

1. Click on Integrations from the left navigation panel in Then, click Available Integrations at the top and choose the Iterable icon. 2. Activate Grow and/or Reclaim. Paste your API Key and click Connect.

3. Set up your Contact Suppression. Once you enable automatic suppression, will sync your regular, opt-in list from your ESP and add it to your suppression list. This prevents you from paying for contacts you already have. Once you’ve enabled this option, the sync will run daily at 6 p.m. EST. Choose YES to automatically suppress contacts, then pick daily contact suppression (recommended).

Daily contact suppression (recommended): This action will load all of your contacts from Iterable into your suppression list and will automatically import new contacts every day into your suppression list. One time suppression: This action will only run once and load your current Iterable contacts into your suppression list.

You'll then need to add your All contacts Segment ID and Recent contacts Segment ID. To create your All contacts Segment ID, go to Audience > Segmentation in Iterable.

Set the conditions shown below. Then, click Save List > Save as a new dynamic list.

Name the list AllContactsSegment, and click Create.

Then, go to Audience > Lists and click on the AllContactsSegment list. Your All contacts Segment ID is the number following "ListID=" (blurred text below).

To create your Recent contacts Segment ID, go to Audience > Segmentation.

Then, set these conditions as shown below. For the date range, you will need to click the calendar and then type in now-1d. When you're finished, click Save List > Save as a new dynamic list.

Name the list RecentContactsSegment, and click Create.

Then, go to Audience > Lists and click on the RecentContactsSegment list. Your Recent contacts Segment ID is the number following "ListID=" (blurred text below).

When you've completed this section, click Next. 4. Then, click Yes to upload collected contacts and choose a list to sync them to. Pick a list from the drop-down menu.

Then, choose whether you want to enable custom sync options. If you check the box to enable custom sync options, that will display five options: filter by email domain, full or portion of a landing page URL, landing page domain, state*, and referrer URL. *Please note that State data is only available on legacy plans that include address data.

This feature allows you to filter your contacts before you send them to your ESP. For example, you can send all contacts who hit different landing pages to separate lists. Or, send all of your California leads to one ESP and Texas leads to another.

Email domain: This field auto-fills/populates with email domains (ex. Gmail, Yahoo Mail, AOL, etc.) from your collected contacts. Full or portion of a landing page URL: If you’ve put the script on several pages or the entire site, this field allows you to pull out contacts who have only hit Landing Page A or Landing Page B. This option does not auto-populate, so you will have to add in the exact URL. Landing page domain: If you added script to both and, for example, the landing page domain would be either or This field will auto-populate. State: This filter allows you to pull out only contacts from one or more states. Please note that State data is only available on legacy plans that include address data. Referrer URL: This is the URL the contact comes to your site from

When you're finished, click Next. 5. Click Yes to Enable your Reclaim data sync. Click Next.

6. Enable the integration. Once you enable the integration, your settings will apply and suppression will begin. Then, click Finish.

7. Once the integration is complete, you will see the integration date, API details, and more. You can also Remove the integration from this page at the top.

Integration Settings

From your Integration's Settings page, you can access, change, or update any of the following:

  • Your API key

  • Grow or Reclaim Activation

  • Suppression settings

  • Grow Sync settings, including the list you're syncing contacts to

  • Sync summary

  • Reclaim sync

To access any of these settings, click Integrations > Dots > Settings.

Sync summary

You can view your daily sync history under Sync Summary on your integration page. It will show you the date, number of completions, if there are any failures, and the number that are in the queue.

Click on a specific date for details, or, to access all of your sync history, click View Full History under Sync Summary. If there's a failure, it will show the email address, what type of failure has occurred under ESP Feedback, and the date and time of the failure.

If you have questions about the error message, you can contact support at support[at]retention[dot]com.

Did this answer your question?