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

Get customer profile

Request

Retrieve your account profile including:

  • Current usage and remaining quota
  • Domain limits and tracking settings
  • API key (masked for security)

Use this to:

  • Monitor monthly email usage
  • Check available resources
  • Verify account status
Security
BearerAuth
curl -i -X GET \
  https://api.mailerlogic.io/api/customer/profile \
  -H 'Authorization: Bearer <YOUR_API Key_HERE>'

Responses

Profile retrieved successfully

Bodyapplication/json
customerobject(CustomerProfile)
Response
application/json
{
  "customer": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme Corp",
    "email": "api@acme.com",
    "status": "active",
    "monthly_email_limit": 100000,
    "max_domains": 5,
    "webhook_url": "https://acme.com/webhooks/mailer",
    "tracking_enabled": true,
    "click_tracking_enabled": true,
    "open_tracking_enabled": true,
    "created_at": "2024-01-15T10:30:00Z",
    "current_domains": 3,
    "emails_sent_this_month": 45230,
    "remaining_emails": 54770
  }
}

Update customer profile

Request

Update customer profile settings such as webhook URL.

Security
BearerAuth
Bodyapplication/jsonrequired
webhook_urlstring(uri)

HTTPS URL for webhook notifications

Example: "https://your-domain.com/webhooks/mailerlogic"
curl -i -X PUT \
  https://api.mailerlogic.io/api/customer/profile \
  -H 'Authorization: Bearer <YOUR_API Key_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "webhook_url": "https://acme.com/webhooks/mailer"
  }'

Responses

Profile updated successfully

Bodyapplication/json
customerobject(Customer)
Response
application/json
{
  "customer": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "email": "user@example.com",
    "status": "active",
    "webhook_url": "http://example.com",
    "tracking_enabled": true,
    "click_tracking_enabled": true,
    "open_tracking_enabled": true,
    "created_at": "2019-08-24T14:15:22Z"
  }
}

Rotate API key

Request

Generate a new API key for the customer account. The old key will be immediately invalidated. Important: Update all applications with the new key immediately.

Security
BearerAuth
curl -i -X POST \
  https://api.mailerlogic.io/api/customer/rotate-key \
  -H 'Authorization: Bearer <YOUR_API Key_HERE>'

Responses

API key rotated successfully

Bodyapplication/json
messagestring
Example: "API key rotated successfully. Update your applications with the new key immediately."
api_keystring

New API key

Example: "ml_live_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
customerobject
Response
application/json
{
  "message": "API key rotated successfully. Update your applications with the new key immediately.",
  "api_key": "ml_live_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "customer": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "email": "user@example.com"
  }
}

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

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