MailerLogic API (1.0.0)

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

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

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

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

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

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

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.

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.

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

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: