There are two ways to send. Complete the matching checklist before you hit send.
Path A — Campaign (newsletter / promo)
Use this for mail you compose in Mailivate.
- Marketing subdomain is verified (Marketing domains).
- List default From is on that subdomain (example:
hello@news.acme.com). - Business address is complete (Workspace details).
- Settings → Request Approval is approved (Account approval).
- The account has an active subscription.
- The campaign has a subject, HTML body, and at least one subscribed recipient.
- Send a test from the Delivery step, then send or schedule.
Step-by-step UI: Creating a campaign → Designing content → Scheduling and sending.
Test vs live
| Test send | Live send | |
|---|---|---|
| Who receives it | Addresses you enter | Subscribers on the list / segment |
| Counts in stats | No | Yes |
| Needs approval + plan | Usually still requires a valid From | Yes — approval, plan, address, domain |
Path B — Transactional API (app email)
Use this for password resets, receipts, and alerts from your backend.
- Transactional domain is verified (Transactional domains).
- Settings → Request Approval is approved (Account approval).
- API token created under Account → API Tokens.
Fromis on that transactional domain (example:noreply@acme.com).- Call
POST https://mailivate.com/api/emailfrom your server (never from browser JavaScript).
Copy-paste examples: Send transactional email (API).
A marketing-only From will be rejected.
From addresses that work
| Send type | Allowed From example | Will fail |
|---|---|---|
| Campaign / automation | hello@news.acme.com |
hello@acme.com if only news.acme.com is the marketing domain |
POST /api/email |
noreply@acme.com |
noreply@news.acme.com if that host is marketing-only |
The local part (hello, noreply) can be whatever you need. The host must match a verified domain for that send type.
If you cannot send
| Message or symptom | Fix |
|---|---|
Account not approved / API 406 |
Submit Settings → Request Approval and wait for approved. Account approval. |
| Add your business address | Complete street, city, region, postal code, country in workspace settings. |
| No subscription | Choose a paid plan under billing. |
| From / domain not allowed | Verify the correct plane and use that exact hostname. Sending domains. |
| DKIM still pending (marketing) | Publish ownership TXT first, Check DNS, then publish the DKIM Mailivate issues. |
| DNS still pending | Wait for propagation, copy values exactly, turn off CDN proxy on CNAMEs. |
| No from email | Set list default From, or the campaign From field. |
| No content / no subject | Finish the Content step. |
| Recipient suppressed | Check Settings → Suppressions. Suppressions. |
API 401 |
New token under Account → API Tokens; send Authorization: Bearer …. |
API 422 on From |
Transactional domain not verified, or From host is a marketing subdomain. |
Permission-based lists only. Do not import purchased or scraped addresses.