Suppressions
Manage per-stream suppression lists to protect your sender reputation. Suppressed email addresses are automatically rejected before sending.
How Suppressions Work
When you send an email, Postject checks the stream's suppression list before queuing the message. If the recipient is found in the suppression list, the message is created with status rejected and is never sent to Amazon SES. This protects your sender reputation by preventing sends to known-bad addresses.
Suppression Reasons
| Reason | Description |
|---|---|
| BOUNCE | Automatically added when a hard bounce is received |
| COMPLAINT | Automatically added when a recipient reports spam |
| MANUAL | Manually added by you via the API or dashboard |
| SPAM | Identified as a known spam trap address |
Automatic Suppression
Hard bounces and spam complaints trigger automatic suppression. When a recipient's mail server permanently rejects an email or a recipient marks your email as spam, Postject automatically adds their address to the stream's suppression list. No action is required from you.
List Suppressions
Returns all suppressed email addresses for a given stream. Requires JWT Bearer authentication.
[
{
"id": "clx_sup_01...",
"email": "bounced@example.com",
"reason": "BOUNCE",
"streamId": "clx_stream_01...",
"createdAt": "2024-01-10T08:30:00.000Z"
},
{
"id": "clx_sup_02...",
"email": "complained@example.com",
"reason": "COMPLAINT",
"streamId": "clx_stream_01...",
"createdAt": "2024-01-12T14:20:00.000Z"
}
]Add a Suppression
Manually add an email address to a stream's suppression list. Requires JWT Bearer authentication.
The email address to suppress.
The suppression reason: BOUNCE, COMPLAINT, MANUAL, or SPAM.
{
"email": "unsubscribed@example.com",
"reason": "MANUAL"
}Remove a Suppression
Removes an email address from a stream's suppression list. Requires JWT Bearer authentication.
Warning
Removing a suppression for a previously bounced address may harm your sender reputation. Only remove suppressions if you are certain the address is now valid and the recipient wants to receive your emails.