Skip to content

MailerLogic API (1.0.0)

Complete REST API for managing email delivery, tracking, and analytics.

Get started in minutes:

  1. Get your API key from your customer dashboard
  2. Send authenticated requests using the X-API-Key header
  3. Start sending emails via SMTP or API

For detailed guides, see the Getting Started section in the navigation.

Download OpenAPI description
customer-api.openapi.json
customer-api.openapi.yaml
Overview
URL
https://support.mailerlogic.com
Support
support@mailerlogic.com
Languages
Servers
US Data Center
https://api.mailerlogic.net
EU Data Center (coming soon)
https://eu-api.mailerlogic.net

Quickstart Guide

Get started with MailerLogic in minutes. This guide walks you through sending your first email.

Features Overview

MailerLogic provides enterprise-grade email delivery infrastructure with powerful APIs, deliverability optimization, and comprehensive analytics. Built by developers, for developers.

Platform & Customer Responsibilities

MailerLogic operates on a shared responsibility model to ensure optimal email deliverability and compliance. We provide the infrastructure and tools, while you control your content and recipient management.

📊 Responsibility Matrix

AreaMailerLogic ResponsibilityYour Responsibility
Deliverability & IP Reputation• Maintain clean shared IP pools
• Auto-throttling and rate limiting
• Blocklist monitoring
• IP warmup scheduling
• Scanner filtering		• Send compliant, opt-in email only
• Avoid spam triggers and blackhat tactics
• Follow warmup guidance
• Monitor sender reputation
Content Quality• Pre-send Content Scoring API
• Spam keyword detection
• HTML validation
• RFC 8058 compliance checks		• Write high-quality, non-spammy content
• Avoid deceptive or prohibited content
• Test emails before sending at scale
Compliance (CAN-SPAM, GDPR, CASL)• Auto-insert RFC 8058 One-Click Unsubscribe headers
• Suppression list management
• Unsubscribe request processing
• Data encryption at rest		• Honor unsubscribes in segmentation
• Obtain consent before sending
• Maintain permission-based lists
• Include required legal disclosures
Reputation Monitoring• Automated Health Score tracking
• Bad Sender detection
• Continuous bounce/complaint monitoring
• Proactive alerting		• Improve campaigns when warned
• Maintain good engagement metrics
• Keep bounce/complaint rates low
Domain & Email Validation• Domain DNS validation
• Detect risky/disposable domains
• Ensure DKIM/SPF/DMARC alignment
• Email syntax validation		• Use legitimate sending domains
• Ensure DNS is configured correctly
• Validate recipients before sending
Security & Infrastructure• Secure MTA infrastructure
• Encrypted data storage
• API authentication
• Bot protection and rate limiting		• Secure API keys
• Maintain account access control
• Follow security best practices
• Rotate keys periodically
Analytics Accuracy• Human-vs-scanner classification
• Click/open filtering
• Bot suppression for metrics
• Real tracking data		• Use analytics responsibly
• Interpret human-only statistics correctly
• Don't rely solely on open rates
Abuse Prevention• Auto-block abusive sending patterns
• Quarantine malicious content
• Stop high-risk sends
• Monitor for policy violations		• Avoid spam/promotional blasts from transactional streams
• Follow terms of service
• Report suspicious activity
Bounce & Complaint Handling• Automatic bounce suppression
• FBL complaint handling
• Auto-removal of bad addresses
• Invalid email detection		• Do not re-upload suppressed contacts
• Maintain clean subscriber lists
• Remove inactive recipients
Email Streams (Transactional/Marketing)• Enforce stream rules
• Ensure transactional traffic stays clean
• Auto-inject proper headers		• Choose correct stream type
• Do not mix marketing content in transactional messages
• Use appropriate templates

✅ What We Handle For You

  • Infrastructure: SMTP servers, IP pools, TLS/encryption, DNS setup
  • Deliverability Tools: Warmup automation, reputation monitoring, content scoring
  • Compliance: One-Click Unsubscribe headers, suppression lists, bounce handling
  • Security: API authentication, encrypted storage, bot detection
  • Analytics: Open/click tracking with scanner filtering

Email Sending

Send transactional and marketing emails via REST API. Simple API for sending individual emails with full tracking support.

Operations

Profile

Manage your customer profile, view usage limits, and rotate API keys. Start here to understand your account settings and available resources.

Operations

SMTP

Get SMTP credentials for sending emails directly through our mail servers. Use these endpoints to retrieve and rotate your SMTP passwords.

Operations

Sending Domains

Add and verify domains for sending authenticated emails. Configure SPF, DKIM, and DMARC records to improve deliverability.

Operations

Tracking Domains

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:

  1. Create tracking domain
  2. Add CNAME record to DNS
  3. Verify DNS configuration
  4. SSL automatically provisions (1-2 minutes)
  5. Assign to sending domains
Operations

Statistics

Access detailed email delivery and engagement metrics. Query sends, bounces, opens, clicks, and spam complaints with flexible date filters.

Operations

Content Scoring

Analyze email content for spam patterns before sending. Get actionable feedback to improve deliverability scores.

Operations

Email Validation

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.

Operations

Risk Assessment

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.

Operations

Events

🔒 Enterprise Feature - Query email lifecycle events with human engagement detection and device analytics.

Operations

Suppressions

Manage system-level suppressions for bounces and spam complaints.

Suppression Types:

  • Hard Bounces: Permanent delivery failures (automatically added by the system)
  • Soft Bounces: Temporary delivery failures (automatically added after threshold)
  • Complaints: Spam complaints and feedback loop reports

Suppression Scope:

  • Global: Applies to ALL your domains (when no domain_id specified)
  • Domain-specific: Applies to a specific domain only

Key Features:

  • Automatic bounce and complaint handling
  • Whitelist management to override suppressions
  • List all suppressions with filtering
  • Manual suppression management

Automated list hygiene to protect your sender reputation and ensure compliance.

Operations

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.

Operations

Health Score

Monitor your account's email health and engagement quality metrics. Get a 0-100 score with reputation grade (A+ to F) and actionable insights.

Operations

Tracking

Public endpoints for open and click tracking. These are called automatically by email clients - no authentication required.

Operations

Outbound Webhooks

MailerLogic sends real-time webhook notifications to your configured endpoint for all email events.

Webhook Scopes:

Customer-Level Webhooks (domain_ids = null or [])

  • Receives events from ALL domains
  • Simplest setup for single-backend applications

Single Domain Webhooks (domain_ids = [uuid])

  • Receives events from ONE specific domain
  • Useful for isolated domains

Domain Group Webhooks (domain_ids = [uuid1, uuid2, ...])

  • Receives events from MULTIPLE specific domains
  • Perfect for grouping related domains when webhook endpoint limits apply
  • Example: Plan has 20 domains, 5 webhook limit → group marketing domains, support domains, etc.

Mixed Approach

  • You can combine all three types
  • Domain-specific/group webhooks fire first, then customer-level
  • Maximize efficiency with limited webhook endpoints

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 timestamp
  • email_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:

Operations