# Add to unsubscribe list

Manually add an email address to your unsubscribe list.
This email will not receive any future emails from your account.

Use cases:
- Manual unsubscribe requests
- Compliance with unsubscribe requests
- Proactive list management

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

## Request fields (application/json):

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

  - `reason` (string)
    Optional reason for unsubscribe
    Example: "User requested removal"

## Response 201 fields (application/json):

  - `message` (string)
    Example: "Email unsubscribed successfully"

  - `unsubscribe` (object)

  - `unsubscribe.id` (string)
    Unique unsubscribe record ID

  - `unsubscribe.email` (string)
    Unsubscribed email address

  - `unsubscribe.source` (string)
    How the unsubscribe occurred
    Enum: "link", "one-click", "api", "manual"

  - `unsubscribe.reason` (string)
    Reason for unsubscribe

  - `unsubscribe.created_at` (string)
    When the unsubscribe occurred

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Invalid email address"

  - `message` (string)

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 409 fields (application/json):

  - `error` (string)
    Example: "Already unsubscribed"

  - `message` (string)