How to Configure a Buyer Suppression List

Creating a Suppression List

Navigate to Setup System > 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 setup_system
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, 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. A suppression list created
without a file is valid and can be populated later
through the API.

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

A suppression list is inert until you attach it to
something. There are three attachment points:

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.
Schedules. Edit a schedule and add the suppression list. Schedule actions will not dial or text numbers on the list.
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.