Send an email
const response = await fetch(
'https://api.emailmassivo.com/api/v1/public/emails',
{
method: 'POST',
headers: {
'Authorization': 'Bearer rs_ck_v1_...',
'Content-Type': 'application/json',
'Idempotency-Key': 'order-1234-confirmation',
},
body: JSON.stringify({
data: {
from: { email: 'noreply@yourdomain.ru' },
to: { email: 'user@example.com' },
subject: 'Your order is confirmed',
html: '<h1>Thanks for your order #1234!</h1>',
},
}),
}
);
const { data } = await response.json(); // 202 Accepted
// data.id → "0199b2f4-6c1e-7a3d-9f2b-4e8c1d7a5b60"
Two use cases, one API
Transactional email
Notifications, order confirmations, password resets, receipts — all through a single endpoint. HTML, attachments, CC/BCC, custom headers.
- Base64 attachments
- CC and BCC
- HTML + plain text
- Idempotency
Contact management
Create lists, import your audience, manage subscriptions and custom fields. Up to 1,000 contacts per import request.
- Lists and contacts
- Import / export
- Custom variables
- Subscription statuses
What's inside
Idempotency
Pass an Idempotency-Key and retried requests return the stored result instead of sending the email again.
Scoped API keys
Issue least-privilege tokens: one scope for sending email, another for managing contacts.
Bulk import
Up to 1,000 contacts per request. Auto-creates custom fields, updates existing contacts, returns a detailed error report.
Per-list variables
Custom fields for email personalization. Every list gets its own set of typed variables with default values.
Structured errors
Machine-readable error codes, per-field details, Retry-After on rate limiting — easy to handle programmatically.
Reliable infrastructure
Built for deliverability: verified domains, DKIM/SPF, per-key reputation control and delivery monitoring.