Suppression List

What the suppression list does

The suppression list is the account-wide block list of addresses EuroMail will not send to. Before every send, the recipient is checked against it; a suppressed address is skipped rather than mailed. This is the single most important safeguard for your sender reputation. It stops you from repeatedly hitting addresses that bounce, complain, or have opted out.

For the full endpoint reference, see the Suppressions API reference.

What gets suppressed automatically

EuroMail adds addresses for you when:

You do not have to do anything for these. The point is that a single bad signal permanently protects you from re-sending to that address.

Adding a suppression manually

Suppress an address yourself, for example when a customer asks by phone, or you learn an address is problematic:

curl -X POST https://api.euromail.dev/v1/suppressions \
  -H "Authorization: Bearer em_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "email_address": "[email protected]",
    "reason": "customer request"
  }'

The reason is free text for your own records and shows up when you list suppressions.

Listing suppressions

curl "https://api.euromail.dev/v1/suppressions?page=1&per_page=100" \
  -H "Authorization: Bearer em_live_your_key_here"

Each entry records the address, the reason/type, and when it was added. Use this to audit why a particular recipient stopped receiving mail.

Importing a list

Moving from another provider? Bring its bounce, complaint and unsubscribe list in one request instead of one call per address:

curl -X POST https://api.euromail.dev/v1/suppressions/import \
  -H "Authorization: Bearer em_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": ["[email protected]", "[email protected]"],
    "reason": "migrated from previous provider"
  }'

• emails takes 1 to 10,000 addresses per request. Split a larger list into several requests.
• reason is optional and applies to every address in the request. It defaults to import.
• Addresses are lower-cased. One that is already suppressed is skipped, not duplicated.

The response tells you what happened:

{
  "data": {
    "inserted": 2,
    "total_requested": 2,
    "invalid_addresses": []
  }
}

inserted counts the new suppressions. invalid_addresses lists the entries that are not valid email addresses; nothing is stored for them. The dashboard's Suppressions page also takes a CSV upload.

Exporting the list

Download every suppression on the account as CSV:

curl https://api.euromail.dev/v1/suppressions/export \
  -H "Authorization: Bearer em_live_your_key_here" \
  -o suppressions.csv

The file has the columns email_address,reason,created_at, the same layout the dashboard's CSV import reads. Import, export and the other suppression endpoints need an API key with the contacts:manage scope.

Transactional vs. marketing suppression

Unsubscribes apply to marketing mail. Critical transactional mail (password resets, receipts, security alerts) is the recipient's own account activity and is generally not subject to an unsubscribe. Mark such sends with "transactional": true (see Sending Emails). Bounces and complaints, however, suppress an address for all mail: if an address hard-bounces, continuing to send even transactional mail to it only damages your reputation.

Removing a suppression

Suppressions are deliberately sticky. They exist to protect you. Remove one only when you are certain the underlying problem is resolved (for example, a customer fixed their mailbox and explicitly asked to resume). Manage removals from the Suppressions page in the dashboard, which records the change in your audit log.

Never bulk-clear suppressions to "reach more people." Every entry is a recipient who bounced, complained, or opted out. Re-mailing them is the fastest route to a blocklisting.

Related

• Bounce & Feedback Loops. How bounces and complaints are detected and fed in.
• Signup Forms. Unsubscribe handling that writes here automatically.
• Deliverability Insights. Monitor your bounce and complaint rates over time.