Andrej Janev avatar
Written by Andrej Janev
Updated over a week ago

This feature is only available on our Business Plan and higher.

1) Whitelist IP Addresses

In order to connect to Cordial you need to whitelist our IP addresses.

  1. Obtain your API key in your Cordial account by clicking on your username in the top right corner and selecting API keys. If you do not have an API key, create a new one and name it ViralSweep.

  2. Click on your key, then click the + IP Address button.

  3. Add the following:
    Description: ViralSweep Server
    IP Address:

  4. Copy your API Key for the next step.

2) Connect to Cordial

When setting up your promotion, go to:

  1. Integrations > Email & SMS.

  2. Click Add Service > Cordial.

3) Complete the connection

To complete the connection within ViralSweep:

  1. Paste your API Key into ViralSweep.

  2. Click Connect.

  3. A menu will appear with your Cordial lists. Choose a list to connect to.

4) You're connected

The promotion is now connected to Cordial and all entries will be sent into the connected list.


What fields do you pass to Cordial?
First Name
Last Name
Email Address
Address 2
Postal Code
Referral Link
Tracking Source
Promotion ID
Referral Source

Do you update subscribers?
Yes, if you run a promotion and we pass someone to Cordial, then you run another promotion in the future and the same person enters, we will automatically update their information in Cordial (if any new information is provided). Mainly, the referral URL will be updated with the newest URL for each promotion they enter.


If you have connected to Cordial and data is not being added to your list, these are the most common reasons as to why:

Email already in Cordial list
The email address entered into the promotion may already be in your Cordial list, so it will not be added again.

Email already entered into ViralSweep
The email address entered into the promotion has already been entered into the promotion previously, so therefore it is not passed to Cordial. This can happen if you set up your Cordial integration after you have already entered the promotion.

Delay in reporting
Cordial is having a delay in reporting. Try checking again in a few hours.

We're here to help

If you have any further questions, please start a Chat. Just "Click" on the chat icon in the lower right corner to talk with our support team.

Did this answer your question?