# Add suppression

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.

Endpoint: POST /api/customer/suppressions
Version: 1.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `email` (string, required)
    Email address to suppress
    Example: "user@example.com"

  - `type` (string)
    Type of suppression
    Enum: "bounce", "complaint", "unsubscribe"

  - `domain_id` (string)
    Optional - Domain ID for domain-specific suppression

  - `reason` (string)
    Optional reason or description
    Example: "User requested removal"

## Response 201 fields (application/json):

  - `message` (string)

  - `suppression` (object)

## Response 400 fields (application/json):

  - `error` (string)
    Error code or message

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message


## Response 409 fields