Suppression list

Block sends to bounced, complained, or unsubscribed addresses.

A suppression is an email address that must not receive further messages. MailingCore blocks sends to suppressed addresses at enqueue time — protecting reputation and honoring GDPR unsubscribe decisions.

Suppressions are created automatically from hard bounces, complaints, and unsubscribe flows. You can also manage the list via API.

Required scopes

Operation	Scope
List / read	`suppressions:read`
Add	`suppressions:write`
Remove	`suppressions:write`

Missing scope returns 403 with Missing required API key scope.

Endpoints

Method	Endpoint	Description
`GET`	`/suppressions`	List suppressed addresses (paginated)
`POST`	`/suppressions`	Add an address manually
`DELETE`	`/suppressions/:email`	Remove suppression (URL-encode the email)

List

GET /suppressions?limit=50&cursor=...
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx

Add

POST /suppressions
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx
Content-Type: application/json

{
  "email": "[email protected]",
  "reason": "manual"
}

Common reason values include bounce, complaint, unsubscribe, and manual.

Remove

DELETE /suppressions/user%40example.com
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx

Dashboard

Contacts with suppressedAt set appear as suppressed in Contacts. The suppression list stays in sync with /suppressions.