How to Configure a Buyer Suppression List

Creating a Suppression List

Navigate to ** Campaigns > Suppression Lists** in the
left sidebar, or go directly to the /buyer_suppressions page. Click New Suppression List in the page's action bar. You must be a superuser with the campaigns permission to access this page.

The new-suppression form asks for two things:

• Suppression Name (required): a descriptive label, such as the advertiser name or the buyer the list belongs to. The help text notes "After you upload a suppression file, you can select it on other buyers by this name."
• Suppression File (optional): an upload button. Your file must contain a header row caller_id, and after upload you are prompted to choose the column that contains the caller number so the importer knows which values to normalize and insert.

Click Create to save.

The /buyer_suppressions index also exposes a Suppression Files tab (/buyer_suppression_files) listing every uploaded file and its processing status.

Attaching a Suppression List

1. Offers. Edit an offer and add the suppression list under the suppression settings. Calls and leads flowing through that offer will skip numbers on the list.
2. Schedules. Edit a schedule and add the suppression list. Schedule actions will not dial or text numbers on the list.
3. Buyers. Attach the list to a specific buyer. The buyer will be skipped during routing when the caller number is on the list, but other buyers on the same offer remain eligible.

The same suppression list can be attached to any combination of offers, schedules, and buyers.

Adding and Removing Numbers via API

Two suppression list operations power the programmatic add and remove flows:

• The add operation normalizes each number, ensures a global Contact exists for it, and links that Contact to the suppression list.
• The remove operation deletes the links. The Contact records themselves are preserved.

Both methods return a status hash listing which numbers were added, which were already present, and which were removed.

CSV Imports

A suppression list backed by an uploaded CSV is processed in batches. Imports are throttled to three
concurrent runs per company per hour, so very large lists may take time to finish. The list's status reflects progress, and the list is not used for routing until the import succeeds.

Deleting a Suppression List

Deletion is blocked if the suppression is referenced by an Outgoing Webhook URL or a Buyer Conversion. Remove those references first. On successful deletion the suppression is removed, and a background process gradually clears its entries in batches during off hours.