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

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

Enterprise Feature - Query granular email lifecycle events and build custom analytics.

Access to historical lifecycle event data is available only for customers whose subscription tier includes this feature. All customers receive the standard send-time response from /api/send, but only eligible tiers can query historical lifecycle data.

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

List unsubscribes

Request

Retrieve your unsubscribe list with filtering and search capabilities.

Use this to:

  • Monitor unsubscribe trends
  • Export unsubscribe lists
  • Audit unsubscribe sources

Similar to: Mailgun Unsubscribes API, Postmark Bounces API

Security
ApiKeyAuth
Query
pageinteger>= 1
Default 1
limitinteger[ 1 .. 100 ]
Default 50
searchstring

Search by email address (partial match)

from_datestring(date)

Filter from date (YYYY-MM-DD)

to_datestring(date)

Filter to date (YYYY-MM-DD)

curl -i -X GET \
  'https://api.mailerlogic.io/api/customer/unsubscribes?page=1&limit=50&search=string&from_date=2019-08-24&to_date=2019-08-24' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Unsubscribes retrieved successfully

Bodyapplication/json
unsubscribesArray of objects(Unsubscribe)
paginationobject(Pagination)
Response
application/json
{
  "unsubscribes": [
    { … },
    { … }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 25,
    "pages": 1
  }
}

Add to unsubscribe list

Request

Manually add an email address to your unsubscribe list. This email will not receive any future emails from your account.

Use cases:

  • Manual unsubscribe requests
  • Compliance with unsubscribe requests
  • Proactive list management
Security
ApiKeyAuth
Bodyapplication/jsonrequired
emailstring(email)required

Email address to unsubscribe

Example: "user@example.com"
reasonstring

Optional reason for unsubscribe

Example: "User requested removal"
curl -i -X POST \
  https://api.mailerlogic.io/api/customer/unsubscribes \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "email": "user@example.com",
    "reason": "User requested removal"
  }'

Responses

Email unsubscribed successfully

Bodyapplication/json
messagestring
Example: "Email unsubscribed successfully"
unsubscribeobject(Unsubscribe)
Response
application/json
{
  "message": "Email unsubscribed successfully",
  "unsubscribe": {
    "id": "string",
    "email": "user@example.com",
    "source": "link",
    "reason": "string",
    "created_at": "2019-08-24T14:15:22Z"
  }
}

Re-subscribe email

Request

Remove an email from your unsubscribe list, allowing them to receive emails again.

Important: Only do this if the recipient has explicitly requested to be re-subscribed.

Security
ApiKeyAuth
Path
emailstring(email)required

Email address to re-subscribe (URL encoded)

curl -i -X DELETE \
  'https://api.mailerlogic.io/api/customer/unsubscribes/{email}' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Email re-subscribed successfully

Bodyapplication/json
messagestring
Example: "Email re-subscribed successfully"
emailstring(email)
Response
application/json
{
  "message": "Email re-subscribed successfully",
  "email": "user@example.com"
}

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

Webhooks

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

Operations