Emailit documentation
Build with email,from first send to scale.
Guides, references and answers for every part of Emailit: the REST API and SMTP relay, inbound mail, campaigns and automations, deliverability, workspaces and billing.
curl https://api.emailit.com/v2/emails \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "Acme <hello@acme.com>",
"to": "ada@example.com",
"subject": "Your receipt",
"html": "<p>Thanks for your order!</p>"
}'import { Emailit } from '@emailit/node';
const emailit = new Emailit(process.env.EMAILIT_API_KEY);
await emailit.emails.send({
from: 'Acme <hello@acme.com>',
to: 'ada@example.com',
subject: 'Your receipt',
html: '<p>Thanks for your order!</p>',
});from emailit import EmailitClient
client = EmailitClient(os.environ["EMAILIT_API_KEY"])
client.emails.send({
"from": "Acme <hello@acme.com>",
"to": "ada@example.com",
"subject": "Your receipt",
"html": "<p>Thanks for your order!</p>",
})$emailit = Emailit::client(getenv('EMAILIT_API_KEY'));
$emailit->emails()->send([
'from' => 'Acme <hello@acme.com>',
'to' => 'ada@example.com',
'subject' => 'Your receipt',
'html' => '<p>Thanks for your order!</p>',
]);host = smtp.emailit.com
port = 587 ; STARTTLS (or 465 for TLS)
username = emailit
password = <your API key>One request, any language. Use an API key from the dashboard.API keys →
Start here
Pick the path that matches how you send. Each quickstart takes about five minutes.
- 5 minSend with the APICreate an API key and send your first email with one HTTP request or an SDK.
- 5 minSend with SMTPPoint any app, framework or CMS at smtp.emailit.com with an API key as the password.
- 3 minConnect an AI assistantGive ChatGPT, Claude, Cursor, Codex or Grok access to Emailit through the hosted MCP server.
- 10 minReceive inbound emailAdd one MX record and get every message delivered to your webhook as JSON.
- 10 minSend your first campaignImport contacts into an audience, design an email and schedule it.
Browse by product
Every product has an overview, how-to guides, reference and limits.
Sending
Transactional email over API and SMTP, inbound mail and events.
- Email APISend, schedule, cancel and retry email with one REST call.
- SMTP relayDrop-in SMTP for any app, framework or CMS.
- TemplatesDrag-and-drop, rich text or HTML templates with Temple variables.
- Inbound emailReceive mail on your domain and process it as JSON.
- Email logsEvery message, delivery attempt, status and request.
- WebhooksSigned, retried, real-time events for 36 event types.
- AnalyticsDelivery, engagement and provider statistics, plus SQL.
Deliverability
Authentication, reputation, tracking and list hygiene.
- Sending domainsAdd a domain, publish SPF, DKIM, DMARC and return-path records.
- Open & click trackingTrack opens and clicks on your own tracking domain.
- DeliverabilitySending health, spam checks, bounces, warm-up and dedicated IPs.
- SuppressionsAutomatic and manual blocks for bounced and complaining addresses.
- DMARC reportsMonitor who sends as your domain with aggregate reports.
- Email verificationCheck addresses one by one or in bulk before you send.
Marketing
Contacts, audiences, forms, campaigns and automations.
- ContactsProfiles with custom fields, import, export and bulk actions.
- AudiencesSubscriber lists with hosted sign-up and unsubscribe.
- FormsEarly accessPopups, flyouts, banners and embedded sign-up forms.
- CampaignsNewsletters and announcements with reports you can share.
- AutomationsBetaVisual workflows triggered by contacts, dates and email events.
Developers & AI
API, SDKs, frameworks and the MCP server.
- REST APIAuthentication, errors, rate limits, filtering and every endpoint.
- SDKs & frameworksOfficial libraries and guides for Node.js, PHP, Python and more.
- MCP serverLet ChatGPT, Claude, Cursor, Codex and Grok work with your Emailit workspaces.
- API keysFull-access and sending keys, domain restrictions and rotation.
Account & platform
Workspaces, members, billing, limits and programs.
- DashboardFind your way around dash.emailit.com.
- Account & securitySign-in, two-factor authentication, passkeys and security.
- WorkspacesMembers, roles, invitations and production access.
- Billing & creditsPlans, credits, auto-refill, invoices and AppSumo.
- Limits & retentionSending limits, plan quotas and data retention.
- Referrals & partnersEarn credits by referring friends, or commission as a partner.
For developers
Everything you need to integrate, test and debug.
- API referenceEvery endpoint with parameters and copy-paste request and response samples.
- WebhooksEvent types, payloads, signatures and retries.
- SDKs & librariesNode.js, PHP, Laravel, Python, Ruby, Go, Java, .NET and Rust.
- Framework guidesNext.js, Nuxt, Laravel, Rails, WordPress and more.
- MCP server113 tools for the whole API, hosted at api.emailit.com/mcp with OAuth 2.1.
- Docs for AIllms.txt, Markdown versions of every page and copy-to-assistant.
Build with your AI agent
Connect ChatGPT, Claude, Cursor, Codex or Grok to the hosted MCP server. Sign in once, choose your workspaces, and your assistant can send email, set up domains and run campaigns for you.
https://api.emailit.com/mcpMore for AI
What's new
Recent changes across the platform.
- MJML editors in alpha
MJML Visual and Code editors with live collaboration, an AI assistant, the MJML API and MJML tools on the MCP server. In alpha and open to the Emailit team only.
Templates
- Nested Temple conditionals and {{cf.*}} in automations
Temple resolves nested {{#if}} blocks correctly, and automation emails accept custom fields as {{cf.<key>}}, the form campaigns and the editors use.
TemplatesAutomations
- Connected apps and multi-workspace access for AI apps
Give an AI app all your workspaces or only the ones you choose, work across them in one chat, and review, edit or revoke every connection under Account > Connected apps.
Account & securityMCP serverWorkspaces
- Emailit plugins for ChatGPT, Codex, Claude Code, Cursor and Grok
One official plugin connects ChatGPT, Codex, Claude Code, Cursor and Grok to Emailit, with skills for domains, deliverability, campaigns, webhooks and SDK code.
MCP server
- Hosted MCP server covers the full API v2
The hosted MCP server now has 109 tools, including campaigns, automations, forms, DMARC reports, email verification and events, with tool annotations and structured results.
MCP serverREST API
Help and reference
- Knowledge baseFixes for DNS, SMTP, delivery, webhooks and billing questions.
- GlossaryFrom API key to workspace, every term in one place.
- Email dictionarySMTP reply codes, enhanced status codes, headers and DNS records.
- ChangelogNew features, improvements and fixes, with RSS.
Get help from people
Questions about your setup? Ask the team and 2,400+ developers on Discord, or email support.