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.

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

Domain Setup & Verification

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:

  • Isolates email reputation from your main website
  • Allows independent DNS configuration
  • Provides better tracking and organization

Q: What if my domain verification fails?

Check that:

  • All DNS records are added correctly (no typos)
  • DNS changes have propagated (can take up to 48 hours)
  • There are no conflicting SPF or DKIM records
  • Your DNS provider supports TXT records

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.


Sending Emails

Q: What's the difference between SMTP and REST API?

  • REST API: Simple HTTP POST endpoint (/api/send) for sending emails with JSON payload - recommended for modern applications
  • SMTP: Standard email protocol, works with all email libraries and clients - better for legacy systems or when using existing SMTP libraries

Q: What SMTP ports do you support?

  • Port 587 (STARTTLS - recommended)
  • Port 2525 (alternative STARTTLS)
  • Port 25 is not supported
  • Port 465 (SSL) may be added in the future

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 depend on your plan and IP reputation:

  • Shared IPs: 100-500 emails/minute
  • Dedicated IPs: 1000+ emails/minute

Q: Why are my emails going to spam?

Common causes:

  • Domain not verified (ensure SPF, DKIM, DMARC configured)
  • Poor content (use content scoring API)
  • Low engagement rates
  • High bounce/complaint rates
  • New IP needs warm-up

Tracking & Analytics

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:

  • Requires images to be enabled
  • Privacy features in Apple Mail/Gmail may block tracking

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:

  • Globally in account settings
  • Per domain
  • Per email (coming soon via API/SMTP headers)

Q: How long do you store tracking data?

  • Event data: 90 days
  • Aggregated statistics: Indefinitely
  • Detailed logs: 30 days

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


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