What Is a Suppression List
A suppression list is a collection of email addresses that your Lettr account will not send to, regardless of any API requests you make. When an address is on your suppression list, Lettr blocks the send before the message ever leaves the platform. Think of it as a safety net. Even if your application attempts to send to a problematic address, Lettr intervenes to protect both your sender reputation and the recipient.Suppression lists operate at the account level. Every Lettr account has its own suppression list that is automatically maintained based on sending activity.
Why Suppression Lists Exist
Suppression lists serve several critical purposes:- Protect sender reputation — Repeatedly sending to invalid or hostile addresses damages your domain and IP reputation with mailbox providers.
- Prevent repeated delivery failures — There is no reason to keep sending to an address that has permanently failed.
- Comply with unsubscribe requests — When a recipient opts out, suppression ensures they stop receiving email from your account.
- Avoid spam complaints — Continuing to send to recipients who have complained increases the likelihood of your mail being blocked entirely.
How Addresses Get Suppressed
Addresses can land on your suppression list through several triggers:| Trigger | Description | Automatic? |
|---|---|---|
| Hard bounce | The recipient address is permanently undeliverable (e.g., mailbox does not exist). | Yes |
| Spam complaint | The recipient marked your email as spam via their mailbox provider. | Yes |
| Unsubscribe | The recipient clicked an unsubscribe link or used a list-unsubscribe header. | Yes |
| Manual addition | You manually add an address through the Lettr dashboard. | No (manual) |
| Repeated soft bounces | A temporary delivery failure occurred too many times for the same address. | Yes (after threshold) |
What Happens When You Send to a Suppressed Address
When your application sends an API request targeting a suppressed address, the following occurs:API request received
Lettr accepts the API call and returns a successful response. No error is returned to the caller.
Suppression check
Before the message is queued for delivery, Lettr checks the recipient against your suppression list.
Send blocked
The email is silently blocked. It never leaves the Lettr platform and is not delivered to any mail server.
Managing Your Suppression List
The suppression list is managed entirely through the Lettr dashboard. There is currently no API endpoint for suppression management.Viewing suppressions
Navigate to Suppressions in the dashboard sidebar to see all suppressed addresses. Each entry shows the email address, the reason for suppression, and the date it was added.Searching for specific addresses
Use the search bar at the top of the suppressions page to look up whether a specific address is on your list.Removing a suppression
You can remove an address from your suppression list by selecting it in the dashboard and clicking Remove suppression.Global vs Account-Level Suppressions
Lettr operates two layers of suppression:- Global suppression list — Lettr maintains a platform-wide list of known-bad addresses, such as role addresses that consistently bounce or addresses associated with spam traps. These suppressions apply across all Lettr accounts and cannot be overridden.
- Account-level suppression list — Your account has its own list, populated by your sending activity (bounces, complaints, unsubscribes, and manual additions). You can manage this list through the dashboard.
Best Practices
Respect suppressions
Respect suppressions
Suppressed addresses are suppressed for a reason. Resist the urge to remove addresses from the list without investigating why they were added. Every suppression protects your sender reputation.
Don't bulk-remove suppressions
Don't bulk-remove suppressions
Removing suppressions in bulk is almost always a mistake. Each removal should be deliberate and justified. Bulk removal can lead to a sudden spike in bounces or complaints that damages your reputation.
Validate before removing
Validate before removing
Before removing a suppressed address, verify that the address is valid using an email validation service. For complaint-based suppressions, confirm that the recipient has explicitly re-opted in.
Use webhooks to sync with your database
Use webhooks to sync with your database
Subscribe to the
email.bounced and email.complained webhook events to keep your own application database in sync with Lettr’s suppression list. This allows you to prevent sending attempts before they even reach the API.Implement proper unsubscribe handling
Implement proper unsubscribe handling
Make it easy for recipients to unsubscribe. A visible, functional unsubscribe link reduces spam complaints and ensures that opt-outs are handled cleanly through suppression rather than through mailbox provider complaints.
Impact on Your Metrics
Suppressed sends are not counted as bounces in your Lettr analytics. They are tracked separately under the Suppressed category. This means your bounce rate reflects only actual delivery attempts that failed, not pre-blocked sends. However, a high volume of suppressed sends can indicate list quality issues. If a significant portion of your sends are being suppressed, it is a signal that your mailing list contains stale or problematic addresses and needs cleanup.Monitor the ratio of suppressed sends to total sends in your dashboard. A rising suppression rate is an early warning sign that your list hygiene practices need attention.
Related Topics
Bounces
Learn how Lettr handles hard and soft bounces and when they lead to suppression.
Complaints & Unsubscribes
Understand how spam complaints and unsubscribe requests are processed.
List Hygiene
Best practices for maintaining a clean, engaged mailing list.
Bounce Codes Reference
A complete reference of bounce codes and what they mean.