Settings
API Keys
Manage keys used to send email and access the MisarMail API.
API Base URL
All requests must use this base URL. Authenticate with Authorization: Bearer msk_...
https://api.misar.io/mail/v1
Your API Keys
API Reference
Full docsSend a transactional email
POST https://api.misar.io/mail/v1/send
Authorization: Bearer msk_<your_key>
Content-Type: application/json
{
"from": { "email": "no-reply@yourdomain.com", "name": "Your App" },
"to": [{ "email": "user@example.com" }],
"subject": "Your verification code",
"html": "<p>Your code is <b>123456</b></p>",
"text": "Your code is 123456"
}
// 200 OK
{ "success": true, "message_id": "msg_xxx", "provider": "smtp" }List campaigns
GET https://api.misar.io/mail/v1/campaigns?limit=20&offset=0
Authorization: Bearer msk_<your_key>
// 200 OK
{
"campaigns": [
{
"id": "cmp_xxx",
"name": "Welcome series",
"status": "sent",
"sent_at": "2026-01-15T10:00:00Z",
"stats": { "sent": 1200, "opens": 420, "clicks": 89 }
}
],
"total": 42
}Node.js / TypeScript
await fetch("https://api.misar.io/mail/v1/send", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.MISARMAIL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
from: { email: "no-reply@yourdomain.com", name: "Your App" },
to: [{ email: user.email }],
subject: "Welcome!",
html: welcomeHtml,
text: welcomeText,
}),
});Optional send fields
cc, bcc, reply_to // additional recipients alias_id // route via a specific SMTP pool tags // string[] for tracking metadata // key→value custom data idempotency_key // prevent duplicate sends