MisarMail API

The MisarMail API lets you programmatically send transactional emails, manage contacts, create campaigns, and access all platform features — the same operations available through the dashboard UI.

Base URL

https://mail.misar.io/api

All API paths in this documentation are relative to this base. For example, POST /v1/send means POST https://mail.misar.io/api/v1/send.

Versioning

Current version: v1

Routes under /api/v1/ are stable. Breaking changes will be announced and versioned. Routes under /api/ (without /v1/) are session-authenticated UI routes.

Authentication

Two authentication methods:

For programmatic access, always use an API key. See Authentication.

Error Format

All errors return JSON with success: false:

{
  "success": false,
  "error": "Human-readable error message"
}

Validation errors (400) add a details field:

{
  "success": false,
  "error": "Validation failed",
  "details": { "fieldErrors": { "to": ["Must have at least 1 recipient"] } }
}

See Error Codes for the full reference.

Plan Limits

All API operations respect the same plan limits as the dashboard UI. A free-plan user cannot create custom domains via API any more than via the UI. See Plan Limits for the full feature matrix.

Quick Start

# 1. Create an API key at mail.misar.io/settings/api-keys

# 2. Send your first email
curl https://mail.misar.io/api/v1/send \
  -H "Authorization: Bearer msk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "from":    { "email": "hello@yourdomain.com", "name": "Your App" },
    "to":      [{ "email": "user@example.com" }],
    "subject": "Hello from MisarMail",
    "html":    "<p>Hello world!</p>",
    "text":    "Hello world!"
  }'

Available Endpoints

Core

Deliverability & Infrastructure

Multi-Channel & Testing

Analytics & Tracking

Account & Billing