Suppression Lists Maintenance

Check this detailed step-by-step instruction and learn how to maintain your suppression lists.

To remove inactive or bounced email addresses/phone numbers and ensure that your emails/sms are delivered to the intended recipients and not marked as spam, the email/phone number lists should be regularly cleaned. You can use one of the following Mailer tools. 


  1. Cleansing lists via the “Cleanse Email/Phone Numbers” button.
  2. Cleansing lists via downloading the Suppression Lists.
  3. Cleansing lists via API.

Cleansing lists via the “Cleanse Email/Phone Numbers” button

You can upload your list, and the system will scrub it against the campaign opt-out list, returning an updated list that excludes unsubscribed emails/phone numbers.

To start the list cleansing process, go to the Campaigns > Email Campaigns (SMS Campaigns) section, choose the relevant campaign, and click the “Cleanse Emails” (“Cleanse Phone Numbers”) button in the “Actions” column.

To select and upload the new email/phone number list, click the “Choose File” button in the “Cleanse Emails” (“Cleanse Phone Numbers”) pop-up window, and click the “Cleanse” button to complete the action. After confirmation, the system will check it against the campaign opt-out list and return an updated list, excluding unsubscribed emails/phone numbers.

Cleansing lists via downloading the Suppression List 

Suppression Lists for each campaign can be easily downloaded as plain text or MD5, depending on the format selected by the Mailer. Additionally, downloading the Suppression Lists triggers a reset of the Non-Compliance counter. 

To download the list, go to the Campaigns > Email Campaigns (SMS Campaigns) section, choose the relevant campaign and click the “Download” button in the “Actions” column button.

You can set the format of the downloaded list by selecting the following options:

  • Encrypted MD5: Check the box to download the emails/phone numbers in the MD5 encrypted format.
    Note: MD5 (Message Digest Method 5) is a cryptographic hash algorithm used to generate a 128-bit digest from a string of any length. It represents the digests as 32-digit hexadecimal numbers.
    Example: The encoded email address “mail@mail.com” will look like this “7905d373cfab2e0fda04b9e7acc8c879”.
  • Encrypted Sha-512: Check the box to download the emails in the Sha-512 encrypted format.
    Note: Sha-512 (Secure Hash Algorithm 512) is a hashing algorithm used to convert text of any length into a fixed-size string. Each output produces a SHA-512 length of 512 bits (64 bytes).
  • Plain Contact: Check the box to download the emails/phone numbers in the plain text format. This option is only available if contacts are stored in Plain&MD5 / Sha512 format.
  • Import Datetime: Check the box to add the contact’s “Creation Date” column to the list.
  • Opt-out IP:  Check the box to add the opt-out IP to the list.
  • Country (for SMS Campaigns): Check the box to add the “Country” column to the list.
  • Verification Status(for Email Campaigns): Check the box to add the contact verification status to the list.
  • Verification Date(for Email Campaigns): Check the box to add the contact verification date to the list.
  • Zip Opt-Out File:  Check the box to download the .zip file format.
    • Password For Zip: Check the box to enter the password for the .zip file.
    • Password: Enter the password for the .zip file.
  • Mailer: Select the mailer to download the opt-outs for the specific mailer or select “All” to download all contacts.
  • Field Separator: Select the field separator for the list (Semicolon, comma, tab, pipe).
  • Domain Suffix (for Email Campaigns): Enter the domain suffix to download contacts for the specified domain only, e.g. gmail.com. You can list the domains using commas. This is an optional parameter.
    Note: Popular domain suffixes include ".com," ". net," ". gov," and ". org," but there are dozens of domain suffixes.
  • From/To: Select the date range to download contacts added to the list during a specified time frame. 

To download the list in the selected format, click the “Download” button.

sha5.1.1

Cleansing lists via API


To cleanse lists via API, go to the Account Settings > API documentation section.

Select the Mailer from the list and click the “Search” button. The system will display the API Token and API documentation for the selected Mailer. To download the documentation in PDF format, click the “Get as PDF” button.



To cleanse contacts please follow the instructions in paragraph “4. Cleanse Contacts” from your API Documentation in the system.


Mailers also can access API documentation from the Mailers > Manage Mailers section. Choose the relevant Mailer, and click the “API doc” button in the “Actions” column. You will be redirected immediately to the API documentation of the selected Mailer.

Read more about the “Manage Mailers” section in this Knowledge Base article.