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.
Pre-send guidance to help you decide whether to send an email.
Returns a risk assessment with a would_block boolean that indicates whether the platform will block this email if you attempt to send it.
Important Contract:
would_block = true, calling /api/v1/send will also block for the same reasonwould_block = false but risk is medium/high, you can still choose to sendRisk Score Ranges:
Hard Blocks (would_block = true):
spamtrap_detected)previous_complaint)disposable_high_confidence)sender_not_verified)risk_score_critical)Stable Reason Codes (for programmatic handling):
disposable_high_confidence - Disposable domain with 90%+ confidencedisposable_medium_confidence - Disposable domain with 50-89% confidencesender_not_verified - DKIM/SPF not verifiedspamtrap_detected - Known spamtrap addressprevious_complaint - Recipient marked previous email as spamprevious_hard_bounce - Hard bounce on previous sendcontent_risk_high - High spam content scorevelocity_first_send_bulk - First send attempt is bulk emailvolume_spike - Unusual sending volume increaseQuota:
/api/v1/risk/stats for usage and remaining quotacurl -i -X POST \
https://api.mailerlogic.net/api/v1/risk/preview \
-H 'Content-Type: application/json' \
-H 'X-API-Key: YOUR_API_KEY_HERE' \
-d '{
"to": "user@example.com",
"subject": "Welcome to our platform",
"html": "<p>Welcome to our platform!</p>",
"text": "Welcome to our platform!",
"is_bulk": false
}'Risk score calculated successfully
Critical field: Indicates if /api/v1/send will block this email. If true, calling /send will result in the same block with the same reason_code.
Platform decision on this send:
allow: Will send without warningswarn: Will send but risk warning shown in logs/dashboardsoft_block: Platform will block /send unless customer takes explicit corrective action (verify domain, remove recipient, fix content). Not the same as "warn" - this requires action.block: Hard block - cannot send under any circumstancesStable machine-readable reason code (null if allowed). Use this for programmatic decision-making.
Actionable recommendations to reduce risk
Enforcement policy settings at time of preview. Use this to correlate why an old preview doesn't match a later /send if settings changed.
{ "risk_score": 15, "risk_level": "safe", "would_block": false, "action": "allow", "reason_code": null, "block_reason": null, "risk_factors": [ { … } ], "breakdown": { "recipient": 5, "content": 5, "sender": 0, "behavior": 0 }, "recommendations": [], "policy_snapshot": { "block_disposable_emails": true, "enforce_sender_verification": true, "disposable_confidence_threshold": 0.85, "customer_plan": "professional" }, "engine_version": "risk-v3.2", "quota": { "used": 43, "limit": 1000, "remaining": 957, "reset_at": "2025-02-01T00:00:00Z" } }
Retrieve usage statistics, trends, and risk analytics for the Risk Score API.
Information provided:
Use this to:
curl -i -X GET \
https://api.mailerlogic.net/api/v1/risk/stats \
-H 'X-API-Key: YOUR_API_KEY_HERE'{ "enabled": true, "quota": { "limit": 1000, "used": 247, "remaining": 753, "reset_at": "2025-02-01T00:00:00Z" }, "analytics": { "total_previews": 247, "average_risk_score": 28.5, "would_block_count": 12, "would_block_percentage": 4.9, "breakdown": { … } }, "top_factors": [ { … }, { … }, { … }, { … }, { … } ] }
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: