Skip to content

Add suppression

Request

Manually add an email to your suppression list for bounces or spam complaints.

Suppression Scope:

  • Global: Omit domain_id to suppress across ALL your domains
  • Domain-specific: Include domain_id to suppress for a specific domain only

Common Use Cases:

  • Manual bounce additions for known bad addresses
  • Adding complaint addresses from external feedback loops
  • Proactive list cleaning based on email validation results
  • Importing suppressions from other platforms

Note: For managing user opt-outs, use the /api/v1/customer/unsubscribes endpoints instead.

Security
ApiKeyAuth
Bodyapplication/jsonrequired
emailstring, (email)required

Email address to suppress

Example:"user@example.com"
typestring

Type of suppression

Default:"unsubscribe"
Enum:"bounce""complaint""unsubscribe"
Example:"unsubscribe"
domain_idstring, (uuid)

Optional - Domain ID for domain-specific suppression

reasonstring

Optional reason or description

Example:"User requested removal"
curl -i -X POST \
  https://api.mailerlogic.net/api/customer/suppressions \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "email": "user@example.com",
    "type": "unsubscribe",
    "reason": "User requested removal"
  }'

Responses

Suppression added successfully

Bodyapplication/json
messagestring
suppressionobject
Response
{
  "message": "string",
  "suppression": {}
}