The MisarMail REST API allows you to manage contacts, send transactional emails, trigger automation events, and retrieve campaign analytics programmatically.
All API requests require an API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Generate API keys from Settings → API Keys. Store keys securely — treat them like passwords. Never include API keys in client-side JavaScript or public repositories.
https://mail.misar.io/api/v1
POST /api/v1/contacts
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"email": "user@example.com",
"first_name": "Jane",
"last_name": "Smith",
"tags": ["customer", "newsletter"],
"custom_fields": {
"company": "Acme Inc",
"plan": "pro"
}
}
POST /api/v1/send
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"to": "user@example.com",
"from": "hello@yourdomain.com",
"subject": "Your order confirmation",
"html": "<p>Thank you for your order!</p>",
"text": "Thank you for your order!"
}
POST /api/v1/events
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
{
"email": "user@example.com",
"event": "purchase_completed",
"properties": {
"order_id": "1234",
"total": 99.00
}
}
Rate limit headers are included in every API response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Complete endpoint documentation with request/response examples is available at mail.misar.io/docs/api.