Send Your First Email in 5 Minutes

This guide walks you from zero to a sent email using the MisarMail API.

What You Need

A MisarMail account at mail.misar.io
A verified sender email address (Settings → Email Accounts)
An API key with the send scope (Settings → API Keys)

Step 1 — Create an API Key

Go to Settings → API Keys
Click New API Key
Name it (e.g., "My App") and select the send scope
Copy the key — it starts with msk_ and is shown only once

Store it in your environment:

# .env
MISARMAIL_API_KEY=msk_your_key_here

Warning: Never commit your API key to source control.

Step 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": "you@yourdomain.com", "name": "You" },
    "to":      [{ "email": "recipient@example.com" }],
    "subject": "Hello from MisarMail",
    "html":    "<h1>It works!</h1><p>Your first email via MisarMail API.</p>",
    "text":    "It works! Your first email via MisarMail API."
  }'

Node.js

const response = await fetch("https://mail.misar.io/api/v1/send", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.MISARMAIL_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    from:    { email: "you@yourdomain.com", name: "You" },
    to:      [{ email: "recipient@example.com" }],
    subject: "Hello from MisarMail",
    html:    "<h1>It works!</h1><p>Your first email via MisarMail API.</p>",
    text:    "It works! Your first email via MisarMail API.",
  }),
});

const data = await response.json();
console.log(data);
// { success: true, message_id: "...", provider: "..." }

Python

import os, requests

res = requests.post(
    "https://mail.misar.io/api/v1/send",
    headers={"Authorization": f"Bearer {os.environ['MISARMAIL_API_KEY']}"},
    json={
        "from":    {"email": "you@yourdomain.com", "name": "You"},
        "to":      [{"email": "recipient@example.com"}],
        "subject": "Hello from MisarMail",
        "html":    "<h1>It works!</h1><p>Your first email via MisarMail API.</p>",
        "text":    "It works! Your first email via MisarMail API.",
    },
)
print(res.json())
# {"success": True, "message_id": "...", "provider": "..."}

Step 3 — Understand the Response

A successful send returns:

{
  "success":    true,
  "message_id": "<unique-message-id>",
  "provider":   "smtp-pool-name"
}

A queued response (auto-retried — not an error):

{
  "success": false,
  "queued":  true,
  "message": "Email queued for retry"
}

Next Steps

Send Email Reference — All request fields, attachments, reply-to
Authentication — Scopes, key rotation, best practices
Rate Limits — Daily and monthly limits per plan
Webhooks — Get notified on opens, clicks, bounces