# Suppressions

Manage system-level suppressions for bounces and spam complaints.

**Suppression Types:**
- **Hard Bounces**: Permanent delivery failures (automatically added by the system)
- **Soft Bounces**: Temporary delivery failures (automatically added after threshold)
- **Complaints**: Spam complaints and feedback loop reports

**Suppression Scope:**
- **Global**: Applies to ALL your domains (when no `domain_id` specified)
- **Domain-specific**: Applies to a specific domain only

**Key Features:**
- Automatic bounce and complaint handling
- Whitelist management to override suppressions
- List all suppressions with filtering
- Manual suppression management

Automated list hygiene to protect your sender reputation and ensure compliance.


## List all suppressions

 - [GET /api/customer/suppressions](https://developers.mailerlogic.com/customer-api.openapi/suppressions/paths/~1api~1customer~1suppressions/get.md): Retrieve all system-managed suppressions (hard bounces, soft bounces, and spam complaints) with filtering capabilities.

Use this to:
- Monitor bounce and complaint trends
- Export comprehensive suppression lists
- Filter by type, domain, or date range
- Track suppression sources and reasons
- Manage whitelist overrides

Suppression Types:
- bounce: Hard and soft bounces (added automatically by the system)
- complaint: Spam complaints and feedback loop reports (added automatically)

Each suppression includes a scope field indicating whether it's global (all domains) or domain-specific.

Note: For user opt-outs and unsubscribes, see the /api/v1/customer/unsubscribes endpoints.

## Add suppression

 - [POST /api/customer/suppressions](https://developers.mailerlogic.com/customer-api.openapi/suppressions/paths/~1api~1customer~1suppressions/post.md): 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.

## Remove suppression

 - [DELETE /api/customer/suppressions/{suppressionId}](https://developers.mailerlogic.com/customer-api.openapi/suppressions/paths/~1api~1customer~1suppressions~1%7Bsuppressionid%7D/delete.md): Remove an email from your suppression list by suppression ID.

Important: Only remove suppressions if:
- The recipient has explicitly requested re-subscription
- You have verified the email address is valid
- For bounces: You have confirmed the email is now deliverable
- For complaints: You have received explicit consent to resume sending