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.
Send the same email template to multiple recipients with personalization.
Mail merge functionality for:
Features:
{{variable}} syntax in subject, HTML, and textvars objectLimits:
Use cases:
Not for: Different emails to each recipient → Use /api/batch instead
Email subject with optional variables {{name}}
HTML email body with variables
Plain text email body with variables
From email (must use verified domain, optional)
Sending domain (optional - auto-extracted from from email if not provided). If provided, must match the domain in from email address.
Stream type is locked to broadcast for bulk sending. Bulk/mail merge emails are marketing/newsletter content and must use the broadcast stream to protect transactional IP reputation.
File attachments sent with every email (sent directly, not stored). Same attachments sent to all recipients.
iCal calendar event in RFC 5545 format (sent directly, not stored). Same calendar invite sent to all recipients.
Array of recipients with personalization variables
curl -i -X POST \
https://api.mailerlogic.net/api/v1/bulk-send \
-H 'Content-Type: application/json' \
-H 'X-API-Key: YOUR_API_KEY_HERE' \
-d '{
"subject": "Hello {{name}}! Special offer inside",
"html": "<h1>Hi {{name}}</h1><p>Use code <strong>{{code}}</strong> for 20% off!</p>",
"text": "Hi {{name}}, Use code {{code}} for 20% off!",
"from": "hello@mail.yourdomain.com",
"track_opens": true,
"track_clicks": true,
"tag": "holiday-sale-2025",
"stream_type": "broadcast",
"recipients": [
{
"email": "john@example.com",
"vars": {
"name": "John",
"code": "JOHN20"
}
},
{
"email": "jane@example.com",
"vars": {
"name": "Jane",
"code": "JANE20"
}
}
]
}'{ "success": true, "queued": 2, "results": [ { … }, { … } ] }
Send a test email with intelligent defaults based on domain health.
Features:
Test Modes:
Best Practice:
/api/v1/customer/domains/test-readiness/:domain_id firstContent Analysis: Set analyze_content: true to receive basic spam word warnings.
Note: This endpoint performs only basic spam detection. For comprehensive content scoring with detailed analysis, use
POST /api/content-score(subject to tier limits).
curl -i -X POST \
https://api.mailerlogic.net/api/v1/customer/test-email \
-H 'Content-Type: application/json' \
-H 'X-API-Key: YOUR_API_KEY_HERE' \
-d '{
"domain_id": "d1234567-e89b-12d3-a456-426614174000",
"from": "test@mail.example.com",
"to": "you@gmail.com",
"subject": "Test Email",
"text": "This is a test email.",
"test_mode": "basic",
"analyze_content": true
}'{ "message": "Test email queued successfully", "email": { "id": "e1234567-e89b-12d3-a456-426614174000", "from": "test@mail.example.com", "to": "you@gmail.com", "subject": "Test Email", "domain": "mail.example.com", "message_id": "<uuid@mail.example.com>", "status": "queued", "tracking": { … } }, "domain_info": { "age_in_days": 3, "has_custom_tracking": false }, "warnings": [ { … }, { … } ], "content_analysis": { "basic_check_performed": true, "spam_words_found": 0, "note": "For detailed content scoring and analysis, use POST /api/content-score (subject to tier limits)" }, "next_steps": [ "Check your inbox and mark the email as 'Not Spam' if it lands in spam", "Send 2-3 more test emails to trusted addresses today", "Gradually increase sending volume over the next 2 weeks", "Monitor your domain health score regularly", "Consider setting up a custom tracking domain to improve deliverability" ] }
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.
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: