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.
- SegmentsDynamic contact lists from rules, for campaigns and automations.
- Event trackingWorkspace and custom events from your app and website, tied to contacts.
- 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 server135 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.
- API accepts single reply-to addresses, Unix keep_until and one run ID
Template reply_to with a single address, suppression keep_until as a Unix timestamp or null, and automation stats with one run ID no longer fail validation.
REST APITemplatesSuppressionsAutomations
- Sending limits that grow with you
Pro and Business limits now grow gradually with your sending, increase requests get a status on the dashboard, and new Pay as you go workspaces start at 100 emails a day until the first credit purchase.
Limits & retentionEmail APISMTP relay
- Design your own unsubscribe page
Pro, Business and Custom workspaces can design the page recipients see when they unsubscribe, in a visual editor: logo, colors, fonts, footer links, texts in several languages, and no Emailit branding.
AudiencesCampaigns
- Segments in alpha
Segments are saved filters over your contacts that campaigns can send to or exclude. Tracked segments also start automations and send webhooks when contacts join or leave. In alpha and open to the Emailit team only.
SegmentsCampaignsAutomationsWebhooks
- A/B tests, sending options and reports for campaigns, and Commerce in alpha
A/B test campaigns, skip recently emailed and unengaged contacts, send throttled or at each recipient's local or best time, and read richer reports. Commerce, for revenue from email and shop data in emails, is in alpha and open to the Emailit team only.
CampaignsAutomationsEvent tracking
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.