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.
Q: Why do I need to verify my domain?
Domain verification proves you own the domain and enables email authentication (SPF, DKIM, DMARC), which significantly improves deliverability and prevents spoofing.
Q: How long does DNS verification take?
DNS changes typically propagate within 1-4 hours, but can take up to 48 hours in some cases.
Q: Do I need a subdomain or can I use my main domain?
We recommend using a subdomain like mail.yourdomain.com for sending. This:
Q: What if my domain verification fails?
Check that:
Use the verify endpoint to see specific failure reasons.
Q: Can I use multiple domains?
Yes! You can add multiple domains to your account (based on your plan limits). Each domain has independent statistics and reputation.
Q: What's the difference between SMTP and REST API?
/api/send) for sending emails with JSON payload - recommended for modern applicationsQ: What SMTP ports do you support?
Q: Can I send attachments?
Yes, attachments are fully supported via SMTP. Maximum email size including attachments is 10MB.
Q: How many recipients can I send to per email?
Maximum 50 recipients per email. For larger lists, send multiple emails or use our bulk sending features.
Q: What's the sending rate limit?
Rate limits are configurable per customer and depend on your IP type:
These are starting defaults. Higher limits available for high-volume senders with good reputation. Contact support to increase your throughput.
Q: Why are my emails going to spam?
Common causes:
Q: How does open tracking work?
We insert a tiny invisible 1x1 pixel image in your emails. When the recipient opens the email and images load, we record the open event.
Limitations:
Q: How does click tracking work?
We automatically rewrite all links to route through our tracking domain. When clicked, we record the event and redirect to the original URL (typically under 100ms).
Q: Can I disable tracking for specific emails?
Yes, tracking can be disabled:
Q: How long do you store tracking data?
Enterprise plans can request extended retention.
Q: What timezone are timestamps in?
All timestamps are in UTC (Coordinated Universal Time) using ISO 8601 format: 2024-03-15T14:30:00Z
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: