Suppression lists

Suppression lists hold addresses that should never be emailed. Paths are relative to https://app.blacklistguard.com/api/v1.

Lists

GET    /suppression-lists
POST   /suppression-lists
PUT    /suppression-lists/{id}
DELETE /suppression-lists/{id}

Returns { suppression_lists: [{ id, name, description, suppression_scope, mailing_list_name, entry_count, is_active, created_at }] }. Create with { name, description, suppression_scope }, where suppression_scope is global (applies to all your sending), mailing_list, or segment. For mailing_list scope also pass mailing_list_id; for segment scope also pass segment_id.

Entries

GET    /suppression-lists/{id}/entries
POST   /suppression-lists/{id}/entries
DELETE /suppression-lists/{id}/entries/{entry_id}

List returns up to 1,000 entries, newest first: [{ id, entry_value, entry_type, normalized_value, created_at, created_by, reason }] (or null when empty). reason is bounce or complaint for an address BlacklistGuard suppressed automatically, and null for one you added by hand or by import.

Add takes one or more addresses, one per line:

POST /suppression-lists/{id}/entries
{ "entries": "old@example.com\nspam-trap@example.net" }

Returns { added, duplicates, message }.

Import a CSV

POST /suppression-lists/{id}/import   (multipart, field "csvFile")

Test an address

POST /suppression-lists/{id}/test
{ "test_value": "user@example.com" }

Returns { suppressed, test_value, reason }, a quick way to check whether a given address would be blocked.