Suppressions

Manage your suppression list to prevent emails from being sent to addresses that have bounced, complained, or been manually suppressed. PostStack automatically adds addresses on hard bounces and complaints, but you can also manage the list manually.

GET

/suppressions

List all suppressed email addresses with pagination.

json

{
  "suppressions": [
    {
      "id": 1,
      "email": "bounced@example.com",
      "reason": "hard_bounce",
      "created_at": "2026-03-20T10:00:00.000Z"
    },
    {
      "id": 2,
      "email": "complained@example.com",
      "reason": "complaint",
      "created_at": "2026-03-21T14:30:00.000Z"
    }
  ],
  "pagination": {
    "total": 24,
    "page": 1,
    "per_page": 20,
    "total_pages": 2
  }
}

POST

/suppressions

Manually add an email address to the suppression list. Emails to suppressed addresses will be blocked from sending.

json

{
  "email": "block-this@example.com",
  "reason": "manual"
}

DELETE

/suppressions/:email

Remove an email address from the suppression list. Use this to re-enable sending to an address that was previously suppressed.

json

{
  "success": true
}

Suppression Reasons

Each suppression entry includes a reason indicating why the address was suppressed:

Reason	Description
`hard_bounce`	Address permanently undeliverable (auto-added)
`complaint`	Recipient reported the email as spam (auto-added)
`unsubscribe`	Recipient unsubscribed from all emails
`manual`	Manually added via API or dashboard