Complete REST API for managing email delivery, tracking, and analytics.
Get started in minutes:
For detailed guides, see the Getting Started section in the navigation.
Manage custom tracking domains for branded click and open tracking. Tracking domains allow you to use your own domain (e.g., track.yourdomain.com) instead of the default mailerlogic.net domain for tracking links and pixels.
Setup workflow:
Enterprise email validation API to reduce bounce rates and protect sender reputation. Real-time validation with syntax checking, domain verification, comprehensive disposable email detection, and MX record validation. Built-in intelligence to identify role accounts and suggest corrections for common typos.
Pre-send risk assessment API for Professional and Enterprise plans. Preview risk scores before sending emails to reduce bounce rates, improve deliverability, and maintain sender reputation. Get detailed risk analysis with actionable recommendations and enforcement policy insights.
Manage system-level suppressions for bounces and spam complaints.
Suppression Types:
Suppression Scope:
domain_id specified)Key Features:
Automated list hygiene to protect your sender reputation and ensure compliance.
Manage user consent and opt-out preferences.
User-Initiated Opt-Outs:
Unsubscribe Scope:
Key Features:
Ensures compliance with CAN-SPAM, GDPR, and other anti-spam regulations.
Retrieve your unsubscribe list with filtering and search capabilities.
Use this to:
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.
curl -i -X GET \
'https://api.mailerlogic.net/api/customer/unsubscribes?page=1&limit=50&search=string&domain_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&from_date=2019-08-24&to_date=2019-08-24' \
-H 'X-API-Key: YOUR_API_KEY_HERE'{ "unsubscribes": [ { … }, { … } ], "pagination": { "page": 1, "limit": 50, "total": 25, "pages": 1 } }
Add an email address to your unsubscribe list for user consent management.
Unsubscribe Scope:
domain_id to unsubscribe from ALL your domainsdomain_id to unsubscribe from a specific domain onlyUse cases:
Note: Unsubscribe links in emails are handled automatically. Use this endpoint for opt-outs from other channels.
Optional - Specify domain ID for domain-specific unsubscribe. Omit for global unsubscribe.
curl -i -X POST \
https://api.mailerlogic.net/api/customer/unsubscribes \
-H 'Content-Type: application/json' \
-H 'X-API-Key: YOUR_API_KEY_HERE' \
-d '{
"email": "user@example.com",
"domain_id": "123e4567-e89b-12d3-a456-426614174000",
"reason": "User requested removal"
}'{ "message": "Email unsubscribed successfully", "unsubscribe": { "id": "string", "email": "user@example.com", "source": "link", "reason": "string", "created_at": "2019-08-24T14:15:22Z" } }
Remove an email from your unsubscribe list, allowing them to receive emails again.
Re-subscribe Scope:
domain_id query param to remove from global unsubscribe listdomain_id query param to remove domain-specific unsubscribeImportant: Only do this when:
Use cases:
curl -i -X DELETE \
'https://api.mailerlogic.net/api/customer/unsubscribes/{email}?domain_id=497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'X-API-Key: YOUR_API_KEY_HERE'{ "message": "Email re-subscribed successfully", "email": "user@example.com" }
MailerLogic sends real-time webhook notifications to your configured endpoint for all email events.
Webhook Scopes:
Customer-Level Webhooks (domain_ids = null or [])
Single Domain Webhooks (domain_ids = [uuid])
Domain Group Webhooks (domain_ids = [uuid1, uuid2, ...])
Mixed Approach
Create customer-level webhook (all domains):
curl -X POST https://api.mailerlogic.net/api/v1/customer/webhooks \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-app.com/webhooks/mailerlogic",
"events": ["email.delivered", "email.opened", "email.clicked", "email.bounced", "email.complained"],
"name": "Production Webhook",
"domain_ids": null,
"is_active": true
}'Create domain group webhook (multiple domains):
curl -X POST https://api.mailerlogic.net/api/v1/customer/webhooks \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://marketing.example.com/webhook",
"events": ["email.opened", "email.clicked"],
"name": "Marketing Domains Group",
"domain_ids": [
"550e8400-e29b-41d4-a716-446655440001",
"550e8400-e29b-41d4-a716-446655440002",
"550e8400-e29b-41d4-a716-446655440003"
],
"is_active": true
}'Create single domain webhook:
curl -X POST https://api.mailerlogic.net/api/v1/customer/webhooks \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://support.example.com/webhook",
"events": ["email.delivered", "email.bounced"],
"name": "Support Domain Only",
"domain_ids": ["550e8400-e29b-41d4-a716-446655440000"],
"is_active": true
}'All webhook events include:
event - Event type (e.g., "email.delivered", "email.opened")timestamp - ISO 8601 timestampemail_id - UUID of the email (except unsubscribe events)tag - Optional tag for filtering/grouping (if provided when sending)metadata - Optional custom metadata object (if provided when sending)Events sent to your endpoint: