Integrate with MailWizz

You can integrate your account directly with MailWizz.

An integration between and MailWizz does three things:

  1. Automatically sends contacts acquired in your account to MailWizz.
  2. Automatically suppresses existing contacts in your MailWizz account.
  3. Ability to set up custom filters to sync filters (ie, send leads from different domains to different segments or ESPs).

What you’ll need

1. Your API (absolute) URL, API Key and to whitelist’s IP addresses. To find your API (absolute) URL, go to Settings > System URLs. From the Scheme drop-down, click HTTPS. Then, copy the API absolute URL.

2. Find your API Key by going to Customers > Customers. Then, click the Options icon.

3. Click Login as this customer.

4. Click API Keys (star icon).

5. Copy your API Key (blurred text).

6. The integration will require IP approval, and you can do that from the API Keys page. Click Options > Update.

7. You will have to whitelist’s IP addresses, which are subject to change without notice. Please contact support at support[at]retention[dot]com for an updated list.

Paste them in a single line with commas in the IP whitelist box. Then, click Save changes.

8. You will also need to whitelist IP addresses by going to Settings > API. Paste’s IP addresses in Allowed IPs. Then, click Save changes.

To get started

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

2. Add your API (absolute) URL and 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 suppress contacts, and pick either daily contact suppression (recommended) or one time suppression. 

Daily contact suppression: This action will load all of your contacts from SalsaEngage 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 SalsaEngage contacts into your suppression list.

When you’re finished, click Next.

4. Click Yes to upload your collected contacts. Pick a list from the drop-down menu to sync the contacts to. 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.

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.

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

When you’re finished, click Next.

NOTE: You can sync contacts via custom filters, but those filter fields will not show with the contacts once in MailWizz. Only the contact’s email address, first name, and last name (if on a name plan) will show in MailWizz.

6. Enable the MailWizz 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, contact suppression, and the option to set/change the list it’s synced to. You can also Remove the integration from this page at the top.

Change the sync’d list

1. To change the list you’ve synchronized with, click IntegrationsDots > Settings.

2. Click the pencil icon next to Contact Sync. Click Yes next to Upload collected contacts if you haven’t already. Then, choose a new list from the dropdown menu. You can also adjust your custom sync options here. Click Save.

Change suppression

1. To change your contact suppression preferences, click Integrations in the left-hand navigation. Then, click the three dots next to the integrated program and select Settings.

2. Click the pencil/edit icon next to Contact Suppression.

3. Click Yes to automatically suppress your contacts.Then, choose whether you want to suppress daily or just this (single) time. When you’re done, click Save. We recommend you use daily sync.

Remove the integration

1. To remove the integration, click Integrations > Dots Remove.

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.

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.