Skip to main content
POST
/
api
/
v1
/
contact-lists
/
{listId}
/
contacts
/
{id}
/
suppress
Suppress Contact
curl --request POST \
  --url https://api.example.com/api/v1/contact-lists/{listId}/contacts/{id}/suppress \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.mailbreeze.com/llms.txt

Use this file to discover all available pages before exploring further.

Suppress a contact to prevent them from receiving any emails. Unlike deletion, suppression preserves the contact record and email history.

​
Path Parameters

​
listId
string
required
The unique list ID (e.g., lst_abc123).
​
id
string
required
The unique contact ID (e.g., cnt_abc123).

​
Request Body

​
reason
string
required
Reason for suppression. One of:
  • manual - Manual suppression by admin
  • unsubscribed - Contact unsubscribed
  • bounced - Email address bounced
  • complained - Contact reported as spam
  • spam_trap - Address identified as spam trap

​
Examples

import { MailBreeze } from "mailbreeze";

const mailbreeze = new MailBreeze({ apiKey: "sk_live_xxx" });
const contacts = mailbreeze.contacts("lst_abc123");

// Suppress manually
await contacts.suppress("cnt_abc123", "manual");

// Suppress due to bounce
await contacts.suppress("cnt_def456", "bounced");

console.log("Contact suppressed");

​
Response

Returns 204 No Content on success with no response body.

​
Suppression Reasons

ReasonDescriptionTypical Use Case
manualManual suppressionAdmin removing contact, legal request
unsubscribedUser opted outUnsubscribe link clicked
bouncedHard bounceInvalid email address
complainedSpam complaintUser marked email as spam
spam_trapKnown spam trapAddress identified as honeypot

​
Errors

CodeHTTP StatusDescription
CONTACT_NOT_FOUND404Contact with this ID doesn’t exist
LIST_NOT_FOUND404List with this ID doesn’t exist
ALREADY_SUPPRESSED409Contact is already suppressed
VALIDATION_ERROR400Invalid suppression reason

​
Notes

Suppressed contacts are automatically added to the domain’s global suppression list. They won’t receive emails from any list in your domain.

​
What happens when a contact is suppressed:

  1. Contact status changes to suppressed
  2. Email is added to global suppression list
  3. All future sends to this email are blocked
  4. Contact record and history are preserved
  5. Contact appears in list stats as suppressed

​
To unsuppress a contact:

Contact our support team if you need to remove a contact from the suppression list. This ensures proper review of bounces and complaints before re-enabling sending.