# Unsubscribes

Manage user consent and opt-out preferences.

**User-Initiated Opt-Outs:**
- Unsubscribe link clicks in emails
- API-based unsubscribe requests
- Domain-specific or global unsubscribe preferences

**Unsubscribe Scope:**
- **Global**: User opts out from ALL your domains
- **Domain-specific**: User opts out from a specific domain only

**Key Features:**
- Add emails to unsubscribe list
- Remove (re-subscribe) emails
- List all unsubscribed emails with filtering
- Automatic enforcement during email sending

Ensures compliance with CAN-SPAM, GDPR, and other anti-spam regulations.


## List unsubscribes

 - [GET /api/customer/unsubscribes](https://developers.mailerlogic.com/customer-api.openapi/unsubscribes/paths/~1api~1customer~1unsubscribes/get.md): Retrieve your unsubscribe list with filtering and search capabilities.

Use this to:
- Monitor user opt-out trends
- Export unsubscribe lists for compliance
- Audit unsubscribe sources (API, link clicks, manual)
- Filter by domain or view all unsubscribes
- Track consent management across your domains

Complete unsubscribe lifecycle management with comprehensive analytics and compliance reporting.

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

Note: For system-managed suppressions (bounces, complaints), see the /api/v1/customer/suppressions endpoints.

## Add to unsubscribe list

 - [POST /api/customer/unsubscribes](https://developers.mailerlogic.com/customer-api.openapi/unsubscribes/paths/~1api~1customer~1unsubscribes/post.md): Add an email address to your unsubscribe list for user consent management.

Unsubscribe Scope:
- Global: Omit domain_id to unsubscribe from ALL your domains
- Domain-specific: Include domain_id to unsubscribe from a specific domain only

Use cases:
- Processing manual unsubscribe requests (phone, email, support tickets)
- Honoring opt-out preferences from other channels
- Importing unsubscribe lists from other platforms
- Domain-specific opt-outs for users who want targeted unsubscribes
- Proactive consent management

Note: Unsubscribe links in emails are handled automatically. Use this endpoint for opt-outs from other channels.

## Re-subscribe email

 - [DELETE /api/customer/unsubscribes/{email}](https://developers.mailerlogic.com/customer-api.openapi/unsubscribes/paths/~1api~1customer~1unsubscribes~1%7Bemail%7D/delete.md): Remove an email from your unsubscribe list, allowing them to receive emails again.

Re-subscribe Scope:
- Global: Omit domain_id query param to remove from global unsubscribe list
- Domain-specific: Include domain_id query param to remove domain-specific unsubscribe

Important: Only do this when:
- The recipient has explicitly requested to be re-subscribed
- You have documented proof of their consent
- You comply with applicable consent regulations (GDPR, CAN-SPAM, etc.)

Use cases:
- Processing re-subscription requests from users
- Honoring preference center updates
- Correcting accidental unsubscribes