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

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

Troubleshooting

Q: Why can't I authenticate via SMTP?

Check:

  • Using correct SMTP credentials (from /api/smtp-credentials)
  • Using STARTTLS on port 587 or 2525
  • No firewall blocking outbound SMTP
  • Credentials not expired

Q: Why are my API requests failing with 401?

Possible causes:

  • Invalid API key (check key is correct and not expired)
  • Wrong header (use Authorization: Bearer YOUR_KEY for most endpoints)
  • Using a key from a different customer account

Q: Why am I getting 429 errors?

You've exceeded the rate limit (1000 requests per 15 minutes). Wait for the reset time indicated in the X-RateLimit-Reset header.

Q: Why aren't my opens/clicks being tracked?

Check:

  • Tracking enabled on your account
  • HTML email (tracking requires HTML)
  • Images enabled in recipient's email client (for opens)
  • Privacy features may block tracking (Apple Mail, Gmail)

Q: Why is my email still queued?

Emails may be queued due to:

  • IP warm-up limits: Daily sending limits during warm-up
  • Domain throttling: Respecting recipient domain rate limits
  • Quota exceeded: Monthly limit reached
  • Reputation issues: Automatic throttling due to bounces/complaints

Support

  • Email: support@mailerlogic.com (24-hour response on business days)
  • Documentation: https://support.mailerlogic.com
  • Status: 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