Skip to main content

Integrate with Cordial

Updated over 2 weeks ago

You can integrate your Retention.com account directly with Cordial.

An integration between Retention.com and Cordial does three things:

  1. Automatically sends contacts acquired in your Retention.com account to Cordial into a list of your choosing.

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

  3. Automatically suppresses existing contacts in your Cordial account.

What you'll need

1. Your Cordial Admin URL and API Key. To find your Cordial Admin URL, login to your Cordial account and copy the part of the URL between 'https://' and /#dashboard.

2. To find you API Key, click your username in the top-right hand corner. Then, click API Keys.

3. Click +New.

4. Give it an API key name, and add a Description and IP Address. You will have to whitelist Retention's IP addresses, which are subject to change without notice. Please contact support at support[at]retention[dot]com for an updated list to input here.

5. Under Permissions, check these boxes.

For Revenue Tracking, please also select the following Orders permissions:

6. When you're finished, click Generate Key.

7. Then, copy the API Key.

8. You'll now need to create an audience in Cordial for automatic Suppression, with the following parameters and save it with (we recommend naming it: retention_suppression_daily):


To get started

1. Click on Integrations from the left navigation panel in Retention.com. Then, click Available Integrations at the top and choose the Cordial icon.

2. Activate Grow and/or Reclaim. Paste your Cordial Admin URL and API Key, and click Connect.

3. Click Yes to upload your collected contacts. Then, choose the list you want to sync contacts to from the drop-down menu.

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, referrer URL, and state*.

*Please note that state data is only available for legacy plans that include address.

This feature allows you to filter your Retention.com 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 Retention.com and Robly.com, for example, the landing page domain would be either Retention.com or Robly.com. 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 for legacy plans that include address.

Referrer URL: This is the URL the contact comes to your site from.

When you're finished, click Next.

4. Set up your Contact Suppression. Once you enable automatic suppression, Retention.com will sync your regular, opt-in list from Cordial and add it to your Retention.com 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).
Enter the name of the audience you created in Cordial in the Suppression Audience Name field (we recommend retention_suppression_daily):

Daily contact suppression (recommended): This action will load all of your contacts from Cordial into your Retention.com suppression list and will automatically import new contacts every day into your suppression list.

5. Click Yes to Enable Reclaim sync. Click Next.

6. Enable the integration. Once you enable the integration, your collection sync settings will apply and 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 change the list you’ve synchronized with, 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?