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 Bearer token
  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
Production API server
https://api.mailerlogic.io/
EU Data Center (Coming Soon)
https://eu.api.mailerlogic.io/

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.

FAQ

Deliverability

Q: What is IP warm-up and do I need it?

IP warm-up gradually increases sending volume on a new IP address to build reputation with ISPs.

You need it for:

  • New dedicated IPs
  • IPs idle for 30+ days
  • Significantly increased volume

We automate this process over 2-4 weeks.

Q: How do I improve my sender reputation?

  • Authenticate your domain (SPF, DKIM, DMARC)
  • Send quality content (use content scoring)
  • Maintain good list hygiene
  • Monitor engagement metrics
  • Follow proper IP warm-up schedules
  • Maintain steady sending patterns

Q: What should my bounce rate be?

  • Good: Below 2%
  • Acceptable: 2-5%
  • Poor: Above 5%

If your bounce rate exceeds 10%, we may pause sending to protect your reputation.

Q: What should my complaint rate be?

  • Good: Below 0.1%
  • Acceptable: 0.1-0.5%
  • Poor: Above 0.5%

Complaint rates above 1% may result in account suspension.

Q: How do suppression lists work?

Suppression lists prevent sending to addresses that have:

  • Hard bounced
  • Soft bounced repeatedly
  • Complained (marked as spam)
  • Unsubscribed
  • Been manually added

Automatic suppression happens immediately.

Q: Can I whitelist specific addresses?

Yes, you can whitelist addresses to bypass suppression. Use this carefully for:

  • Test accounts
  • Internal email addresses
  • Verified opt-in addresses only

Security & Compliance

Q: How secure is my data?

  • All API requests use HTTPS (TLS 1.2+)
  • SMTP uses STARTTLS/SSL/TLS
  • API keys encrypted at rest
  • Database connections encrypted
  • Regular security audits

Q: Can I rotate my API key?

Yes, use the /api/customer/rotate-key endpoint. The old key is invalidated immediately, so update all applications with the new key.

Q: Can I rotate my SMTP password?

Yes, use the /api/smtp-credentials/rotate endpoint with your X-API-Key header.

Q: Is MailerLogic GDPR compliant?

Yes, we provide:

  • Data processing agreements (DPA)
  • Right to erasure (deletion)
  • Data export capabilities
  • Privacy-focused tracking options
  • Opt-out/unsubscribe management

Q: How do I implement unsubscribe?

We automatically add:

  • List-Unsubscribe header (standard email client unsubscribe)
  • One-click unsubscribe (RFC 8058 compliant)
  • Unsubscribe link

You can also manage suppressions via API.

Q: What data do you collect?

We collect:

  • Sending data: From, to, subject, timestamps
  • Tracking data: Opens, clicks, IP addresses, user agents
  • Event data: Bounces, complaints, delivery status
  • Account data: Usage statistics, API access logs

We do NOT store full email content or attachments.

Technical Questions

Q: What programming languages do you support?

MailerLogic works with any language that supports SMTP (Python, Node.js, PHP, Ruby, Java, Go, C#) or HTTP/REST. Documentation includes examples in cURL, Node.js, Python, and PHP.

Q: Do you have SDKs or libraries?

Official SDKs coming soon. For now, use:

  • Standard SMTP libraries (Nodemailer, PHPMailer, Python smtplib)
  • HTTP clients for REST API calls

Q: What's your API rate limit?

1000 requests per 15 minutes per IP address.

Rate limit headers included:

  • X-RateLimit-Limit: Request limit
  • X-RateLimit-Remaining: Requests remaining
  • X-RateLimit-Reset: Reset timestamp

Contact support for higher limits.

Q: Do you have a sandbox environment?

Sandbox environment coming soon. For now, use:

  • Small test sends on production
  • Content scoring API for pre-send testing
  • Test domains with low volumes

Q: How do I test webhooks locally?

Use tools like:

  • ngrok: Creates public URLs for localhost
  • RequestBin: Captures webhook requests
  • webhook.site: Free webhook testing

Q: Can I use MailerLogic behind a firewall?

Yes, but ensure your firewall allows:

  • Outbound HTTPS (port 443) for API calls
  • Outbound SMTP (port 587 or 2525) for email sending

Q: What's your uptime SLA?

We target 99.9% uptime. Enterprise plans include:

  • SLA guarantees
  • Priority support
  • Status page notifications

Status page: https://status.mailerlogic.com

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

Domains

Add and verify sender domains for email authentication. Configure SPF, DKIM, and DMARC records to improve deliverability.

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

Events

Query granular email events and build custom analytics. Enterprise feature - must be enabled on your account.

Operations

Unsubscribe Management

Manage unsubscribes programmatically with full CRUD operations. Track unsubscribe sources and maintain compliance with anti-spam laws. Similar to Mailgun's Unsubscribes API and Postmark's Bounces API.

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. Similar to SendGrid's Engagement Quality API.

Operations

Tracking

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

Operations

Webhooks

Receive real-time notifications for bounces and complaints. Configure these endpoints in your mail server or monitoring tools.

Operations