# Emailit Docs

> Guides, quickstarts, API reference and knowledge base for Emailit: send with the REST API or SMTP, receive inbound mail, run campaigns and automations, and manage workspaces and billing.

Every page is also available as Markdown: add `.md` to its URL without the trailing slash (for example https://emailit.com/docs/quickstart/api.md). The full text of all pages is at https://emailit.com/docs/llms-full.txt.

Key facts: REST API base URL https://api.emailit.com/v2 (Bearer API key). SMTP host smtp.emailit.com, ports 587 (STARTTLS), 465 (TLS), 2525/2587/25, username `emailit`, password = API key.

MCP: hosted server https://api.emailit.com/mcp (Streamable HTTP, stateless POST). Sign in with OAuth 2.1 + PKCE (scopes `full` or `sending`, access to all or selected workspaces, managed under Account > Connected apps) or send `Authorization: Bearer <api key>`. 109 tools in 15 toolsets (workspace, emails, domains, dmarc, templates, api_keys, audiences, contacts, suppressions, webhooks, campaigns, automations, forms, verification, events); filter with `?toolsets=` and `?read_only=true` or the X-MCP-Toolsets and X-MCP-Readonly headers. With OAuth, every tool outside the workspace toolset also takes an optional `workspace` argument (ID or exact name) for that call. Official plugin for ChatGPT, Claude, Cursor, Codex and Grok, with skills for coding agents: https://github.com/emailit/emailit-plugins. Tool reference: https://emailit.com/docs/mcp/tools.md

## Get started

- [Choose between the API and SMTP](https://emailit.com/docs/get-started/api-or-smtp.md): Compare the Emailit REST API with the SMTP relay feature by feature, from templates and scheduling to idempotency and webhooks, and pick the right one.
- [Go-live checklist](https://emailit.com/docs/get-started/go-live.md): Everything to check before you send production email with Emailit, from DNS, production access and API keys to webhooks, suppressions, limits and warm-up.
- [How Emailit works](https://emailit.com/docs/get-started/how-emailit-works.md): The Emailit mental model in one page. Workspaces, domains and API keys, the ways to send and receive, the life of an email, credits and sandbox mode.
- [Migrate from Amazon SES](https://emailit.com/docs/migrate/amazon-ses.md): Move from Amazon SES to Emailit. Map identities, sandbox and quotas, replace SDK calls and SMTP credentials, and turn SNS events into signed webhooks.
- [Migrate to Emailit](https://emailit.com/docs/migrate.md): Move from another email provider to Emailit without downtime. What to move, in which order, how to run both providers in parallel, and how to cut over.
- [Migrate from Mailgun](https://emailit.com/docs/migrate/mailgun.md): Move from Mailgun to Emailit. Map domains, keys and routes, convert form-encoded API calls to JSON, and move SMTP, webhooks, suppressions and templates.
- [Migrate from Postmark](https://emailit.com/docs/migrate/postmark.md): Move from Postmark to Emailit. Map servers, message streams and tokens, convert API fields, swap SMTP settings, and move webhooks, suppressions and templates.
- [Migrate from Resend](https://emailit.com/docs/migrate/resend.md): Move from Resend to Emailit. The APIs are close, so changes are small. Map fields, SMTP settings and webhook events, verify signatures and move contacts.
- [Migrate from SendGrid](https://emailit.com/docs/migrate/sendgrid.md): Move from SendGrid to Emailit. Map concepts, API fields, SMTP settings and Event Webhook names, then bring over suppressions, dynamic templates and DNS.
- [Send your first email with the API](https://emailit.com/docs/quickstart/api.md): Verify a domain, create an API key and send your first email with cURL or an official SDK for Node.js, Python, PHP, Ruby, Go, Java, .NET or Rust.
- [Send your first campaign](https://emailit.com/docs/quickstart/campaign.md): Create an audience, import contacts, build a campaign in the five-step editor with merge tags, send a test, schedule it and read the report.
- [Receive your first inbound email](https://emailit.com/docs/quickstart/inbound.md): Add the inbound MX record, send a test message to your inbound subdomain, find it in the dashboard, and process it with an email.received webhook and the API.
- [Connect an AI assistant](https://emailit.com/docs/quickstart/mcp.md): Connect ChatGPT, Claude, Cursor, Codex or Grok to Emailit in about three minutes, sign in with OAuth, choose your workspaces and try your first prompts.
- [Send your first email over SMTP](https://emailit.com/docs/quickstart/smtp.md): Get your SMTP credentials, pick a port and send a test email through smtp.emailit.com with swaks, OpenSSL or Python, then connect your app or framework.

## Sending

- [Advanced analytics](https://emailit.com/docs/analytics/advanced.md): Read the seven Advanced analytics charts, from SMTP response codes to time to inbox and delivery by provider, and use them to diagnose delivery problems.
- [Analytics dashboard](https://emailit.com/docs/analytics/dashboard.md): Use the Analytics Dashboard tab to track bounce and complaint rates and build a widget grid of sends, bounces, opens, clicks and breakdowns.
- [Analytics](https://emailit.com/docs/analytics.md): Track sends, bounces, complaints, opens and clicks over time with a customizable dashboard, advanced delivery charts, and SQL queries on higher plans.
- [Queryable SQL](https://emailit.com/docs/analytics/queryable.md): Query your sending data with the Queryable builder or raw ClickHouse SQL, learn the available tables and limits, and start from example queries.
- [Attachments](https://emailit.com/docs/email-api/attachments.md): Attach files to API emails as base64 content or from a URL, embed inline images with Content-ID, and stay within allowed file types and size limits.
- [Headers and metadata](https://emailit.com/docs/email-api/headers-and-metadata.md): Add custom email headers and List-Unsubscribe to API sends, see which headers Emailit adds or rewrites, and attach metadata that comes back in webhooks.
- [Idempotent requests](https://emailit.com/docs/email-api/idempotency.md): Use the Idempotency-Key header to retry send and forward requests safely. Key format, the 24-hour window, replays, 409 and 503 responses, and key strategies.
- [Email API](https://emailit.com/docs/email-api.md): Send transactional email with one HTTPS request, then schedule, cancel, retry or forward it. Base URL, authentication, features and limits.
- [Retry and forward emails](https://emailit.com/docs/email-api/retry-and-forward.md): Resend a bounced, failed, suppressed or held email as a new email, or forward a sent email to another recipient, from the dashboard or the API.
- [Schedule and cancel emails](https://emailit.com/docs/email-api/scheduling.md): Send an email later with scheduled_at, change the send time, or cancel a scheduled, accepted or retrying email from the API or the dashboard.
- [Send an email](https://emailit.com/docs/email-api/send-email.md): Send email with POST /emails, covering sender rules, recipients, content, templates, tracking, the response, webhook events and every error code.
- [Forward inbound email with automations](https://emailit.com/docs/inbound/forward-with-automations.md): Use the Forward received email automation to send every received message, or only matching ones, to another inbox without writing code.
- [Inbound email](https://emailit.com/docs/inbound.md): Receive email at any address on a subdomain of your verified domain, get an email.received webhook, and fetch the full message with the API.
- [Process inbound email with webhooks](https://emailit.com/docs/inbound/process-with-webhooks.md): Subscribe a webhook to email.received, verify each request, then fetch the body, headers and attachments of every received message with the API.
- [Set up inbound email](https://emailit.com/docs/inbound/set-up.md): Publish the inbound MX record for your verified domain, choose the inbound subdomain, verify the record and send a test message.
- [Compose an email](https://emailit.com/docs/logs/compose.md): Send a one-off email from the Emailit dashboard to test a domain or send a quick note, with optional API key attribution.
- [Email details](https://emailit.com/docs/logs/email-details.md): Read one email's headers, content, attachments, delivery attempts, opens, clicks and spam checks, and forward, cancel or retry it.
- [Email statuses](https://emailit.com/docs/logs/email-statuses.md): Every email status in Emailit, what it means, whether it can still change, which webhook event it sends, and what to do next.
- [Events](https://emailit.com/docs/logs/events.md): Browse the events Emailit records for your workspace in the dashboard or with the Events API, and use them to backfill or reconcile webhooks.
- [Email logs](https://emailit.com/docs/logs.md): Find any email you sent or received, see what happened to it, and inspect the API and SMTP requests and events behind it.
- [Request logs](https://emailit.com/docs/logs/request-logs.md): Inspect every API v2 request and SMTP transaction made with your API keys, including request and response bodies, to debug 4xx errors.
- [SMTP headers and replies](https://emailit.com/docs/smtp/headers.md): Which headers Emailit adds, rewrites or removes on SMTP mail, how to read email IDs from the 250 reply, and how to add List-Unsubscribe yourself.
- [SMTP relay](https://emailit.com/docs/smtp.md): Send email from any app, framework or device that speaks SMTP. Connection details, how relayed mail shows up in Emailit, and how SMTP differs from the API.
- [SMTP settings](https://emailit.com/docs/smtp/settings.md): Reference for the Emailit SMTP relay, covering host, ports and TLS modes, authentication, From address rules, message size, rate limits and password rotation.
- [SMTP troubleshooting](https://emailit.com/docs/smtp/troubleshooting.md): Every reply code the Emailit SMTP relay can return, with its cause and fix, plus blocked ports, TLS errors, timeouts and accepted mail that isn't delivered.
- [Create and edit templates](https://emailit.com/docs/templates/editors.md): Create a template, choose the Dragit, Rich Text or HTML editor, insert variables, and manage templates from the template list and template page.
- [Import, export and duplicate templates](https://emailit.com/docs/templates/import-export.md): Import templates from Dragit JSON, HTML or ZIP packages with images, export them again, duplicate templates, and save a campaign as a template.
- [Templates](https://emailit.com/docs/templates.md): Design an email once and reuse it in API sends, automations and campaigns. Aliases, versions, three editors, Temple variables and the Templates API.
- [Temple template language](https://emailit.com/docs/templates/temple.md): Temple fills variables, defaults and conditionals into email subjects, HTML and text at send time. Syntax, truthiness, escaping and where Temple runs.
- [Template versions](https://emailit.com/docs/templates/versions.md): Versions share an alias so you can draft, test and publish a new design without changing code. How publishing works in the dashboard and the API.
- [Event types](https://emailit.com/docs/webhooks/event-types.md): Every webhook event type Emailit sends, when each one fires, which object it carries, and which types the dashboard picker leaves out.
- [Webhooks](https://emailit.com/docs/webhooks.md): Get signed HTTP notifications when emails are delivered, bounce, are opened or clicked, arrive on your inbound domain, or when resources change.
- [Verify webhook signatures](https://emailit.com/docs/webhooks/request-signature.md): Check that webhook requests come from Emailit by verifying the HMAC-SHA256 signature and timestamp, with code for Node.js, Python, PHP, Ruby, Go and Laravel.
- [Retries and failures](https://emailit.com/docs/webhooks/retries-and-failures.md): How Emailit retries failed webhook requests, when it emails you and disables an endpoint, and how to inspect and resend failed requests.
- [Set up a webhook](https://emailit.com/docs/webhooks/set-up.md): Create a webhook endpoint, choose its events, add payload filters, send a test event, and enable, disable or rotate the secret.
- [Webhook requests](https://emailit.com/docs/webhooks/webhook-requests.md): The exact format of Emailit webhook requests, from method and headers to the JSON array of events, plus ordering, duplicates and how to respond.

## Deliverability

- [Email deliverability best practices](https://emailit.com/docs/deliverability/best-practices.md): A practical checklist for reaching the inbox: authentication and DMARC alignment, consent, unsubscribes, list hygiene, content and Gmail and Yahoo sender rules.
- [Bounces and complaints](https://emailit.com/docs/deliverability/bounces-and-complaints.md): How Emailit handles hard and soft bounces, retries temporary failures, processes late bounces and spam complaints, and suppresses addresses automatically.
- [Dedicated IPs](https://emailit.com/docs/deliverability/dedicated-ips.md): The difference between Emailit's shared IP pools and a dedicated IP, when a dedicated IP is worth it, and how to request one and warm it up.
- [Deliverability](https://emailit.com/docs/deliverability.md): What decides whether your email reaches the inbox, what Emailit handles for you automatically, and where to start improving your inbox placement.
- [Sending health](https://emailit.com/docs/deliverability/sending-health.md): How Emailit scores sending health from 0 to 100 using bounce rates, what Healthy, At risk, Paused and Suspended mean, and how healthy sending raises limits.
- [Spam checks](https://emailit.com/docs/deliverability/spam-checks.md): How Emailit scores every outgoing email with Rspamd, why messages scoring 7 or more are held, how to read Spam Checks and how to fix and resend.
- [Warm up a domain or IP](https://emailit.com/docs/deliverability/warm-up.md): Build sending reputation on a new domain or dedicated IP by increasing volume gradually, with an example ramp schedule and how Emailit's sending limits fit in.
- [DMARC reports](https://emailit.com/docs/dmarc.md): Collect DMARC aggregate and forensic reports from mailbox providers in a hosted Emailit mailbox and see who sends as your domain and whether their mail passes.
- [Read DMARC reports](https://emailit.com/docs/dmarc/reports.md): Understand pass rate, alignment and dispositions in DMARC reports, identify unknown senders, and move your policy from none to quarantine to reject safely.
- [Set up DMARC reports](https://emailit.com/docs/dmarc/set-up.md): Turn on DMARC reports for a sending domain, publish or update your _dmarc record with Emailit's reporting address, and upload reports you already have.
- [Add a sending domain](https://emailit.com/docs/domains/add-a-domain.md): Add your domain to Emailit, publish the DNS records it generates, send them to a developer if needed, and verify the domain so you can send.
- [Set up DNS with Cloudflare](https://emailit.com/docs/domains/cloudflare.md): Create every DNS record for a sending domain in your Cloudflare zone in one step with a scoped API token, then re-sync or disconnect it later.
- [DNS records for sending domains](https://emailit.com/docs/domains/dns-records.md): Every DNS record Emailit generates for a sending domain, what each one does, how to enter it at your DNS provider and how to check it with dig.
- [Sending domains](https://emailit.com/docs/domains.md): Why Emailit needs your own domain, which DNS records it sets up for authentication, tracking and inbound mail, and how domains stay verified.
- [Domain limits](https://emailit.com/docs/domains/limits.md): How many sending domains each Emailit plan and AppSumo license includes, what happens when you reach the limit and how to raise it.
- [Domain verification](https://emailit.com/docs/domains/verification.md): How Emailit verifies sending domains, what each domain and record status means, how manual review and daily re-checks work, and how to fix failures.
- [Email verification](https://emailit.com/docs/email-verification.md): Check whether email addresses are valid and safe to mail before you send, one at a time or in lists of up to 10,000, with a result, risk level and 0–100 score.
- [Verify a list](https://emailit.com/docs/email-verification/lists.md): Verify up to 10,000 email addresses at once by pasting them or uploading a CSV or XLSX file, follow progress, review results and export them as XLSX.
- [Verification results](https://emailit.com/docs/email-verification/results.md): Reference for every email verification result, risk level and check, how the 0–100 score is calculated, and what to do with each kind of address.
- [Verify a single address](https://emailit.com/docs/email-verification/single.md): Verify one email address in the dashboard or with the API, choose between fast and full mode, and use verification to catch bad addresses at sign-up.
- [Suppressions](https://emailit.com/docs/suppressions.md): How Emailit's suppression list stops mail to addresses that bounced, complained or opted out, what each type blocks, and how entries are added and expire.
- [Manage suppressions](https://emailit.com/docs/suppressions/manage.md): View, filter, add, import, export and delete suppressions in the dashboard or with the API, configure automatic suppression, and resend suppressed emails.
- [Set up a custom tracking domain](https://emailit.com/docs/tracking/custom-tracking-domain.md): Publish the tracking CNAME for your sending domain, verify it, and turn on open and click tracking so links and pixels use your own hostname over HTTPS.
- [Open and click tracking](https://emailit.com/docs/tracking.md): How Emailit tracks opens with a pixel and clicks with rewritten links on your own domain, how accurate the data is, and how to turn tracking on or off.

## Marketing

- [Audiences](https://emailit.com/docs/audiences.md): Audiences are the lists your campaigns send to. Create audiences, manage subscribers, check your plan's subscriber limit and use audiences through the API.
- [Subscribe URL](https://emailit.com/docs/audiences/subscribe-url.md): Every audience has a hosted subscribe URL that adds people without an API key. Learn the request format, how to call it safely, its limits and how to reset it.
- [Manage subscribers](https://emailit.com/docs/audiences/subscribers.md): Add people to an audience, edit them, turn their Subscribed flag on or off, and remove them, in the dashboard or with the Subscribers API.
- [Unsubscribes](https://emailit.com/docs/audiences/unsubscribes.md): How people opt out of campaigns, what the unsubscribe link and headers do, where unsubscribes appear in reports, and how to manage opt-outs yourself.
- [Automations](https://emailit.com/docs/automations.md): Automations run steps such as sending an email, waiting or updating a contact when a trigger fires. Learn contexts, statuses, runs, credits and the API.
- [Automation recipes](https://emailit.com/docs/automations/recipes.md): The six ready-made automation templates, from welcome and birthday emails to bounce alerts and forwarding, with their steps and what to fill in.
- [Automation runs and stats](https://emailit.com/docs/automations/runs.md): Follow an automation's runs, read the overview and per-step statistics, debug failed runs, and fetch runs and stats with the API.
- [Automation steps](https://emailit.com/docs/automations/steps.md): Reference for every automation step, from send email, wait and condition to audience, contact and suppression steps, plus branches and step failures.
- [Automation triggers](https://emailit.com/docs/automations/triggers.md): Reference for every automation trigger by context, with their options and filters, what fires them, and the trigger keys to use with the API.
- [Create a campaign](https://emailit.com/docs/campaigns/create.md): Walk through the five-step campaign wizard, from choosing audiences and the sender to content, testing and sending, and see exactly who receives it.
- [Campaigns](https://emailit.com/docs/campaigns.md): Campaigns send one email to the subscribers of your audiences. Learn the requirements, statuses, credit cost and what the Campaigns list and API can do.
- [Merge tags](https://emailit.com/docs/campaigns/merge-tags.md): Personalize campaign subjects and content with merge tags for names, email, custom fields and the unsubscribe link, and see how they differ from Temple.
- [Campaign reports](https://emailit.com/docs/campaigns/reports.md): Read a campaign report: every delivery and engagement metric, results by mailbox provider, who loaded and clicked, unsubscribes and the PDF export.
- [Test and schedule a campaign](https://emailit.com/docs/campaigns/test-and-schedule.md): Send test emails, preview a campaign as a real contact, send it now or schedule it, cancel a schedule, and follow what happens while a campaign is sending.
- [Custom fields](https://emailit.com/docs/contacts/custom-fields.md): Define custom fields for your contacts, set their values from the dashboard, imports and the API, and use them in filters, campaign merge tags and automations.
- [Import and export contacts](https://emailit.com/docs/contacts/import-export.md): Import contacts from a CSV or Excel file with the import wizard, export filtered contacts to CSV or XLSX, and run bulk actions and exports with the API.
- [Contacts](https://emailit.com/docs/contacts.md): Contacts are the people in your workspace. See how contacts, audiences and subscribers relate, what the Contacts list and profile show, and how opt-outs work.
- [Build a form](https://emailit.com/docs/forms/build.md): Use the form builder to add steps, text, images, buttons and input fields, style the form, preview it on each device and publish it once the checks pass.
- [Forms](https://emailit.com/docs/forms.md): Build popup, flyout, banner, full-page and embedded sign-up forms in the dashboard, publish them to your site with one script tag, and collect submissions.
- [Install forms on your site](https://emailit.com/docs/forms/install.md): Add the Emailit script to your site once, place embedded forms, open forms from your own code, and manage form tokens, publishing and submissions.

## Developers

- [API keys](https://emailit.com/docs/developers/api-keys.md): Create Full Access and Sending Only API keys, restrict them to a domain, use them for SMTP, and rotate them without downtime.
- [Developer overview](https://emailit.com/docs/developers.md): Base URL, authentication, object IDs, errors, pagination, rate limits, SDKs, webhooks and MCP. The conventions every Emailit integration shares.
- [Docs for AI and agents](https://emailit.com/docs/developers/llms-txt.md): Give ChatGPT, Claude, Cursor, Codex, Grok and other AI tools accurate Emailit context with llms.txt, Markdown pages, the MCP server and the Emailit plugin.
- [Build an OAuth app](https://emailit.com/docs/developers/oauth-apps.md): Let users connect your app to their Emailit workspace with OAuth 2.1 and PKCE, including client registration, token refresh, revocation and errors.
- [Send email with .NET](https://emailit.com/docs/frameworks/dotnet.md): Send email from ASP.NET Core and .NET with the Emailit NuGet package, MailKit or System.Net.Mail over SMTP, and verify Emailit webhooks.
- [Send email with Go](https://emailit.com/docs/frameworks/go.md): Send email from Go with the emailit-go SDK or net/smtp, handle API errors, and verify Emailit webhook signatures in a net/http handler.
- [Send email with Java](https://emailit.com/docs/frameworks/java.md): Send email from Java with the emailit-java SDK or Spring Boot and Jakarta Mail over SMTP, and verify Emailit webhooks in a Spring controller.
- [Send email with Laravel](https://emailit.com/docs/frameworks/laravel.md): Send Laravel mail through Emailit with the emailit/emailit-laravel mail transport and facade, or plain SMTP, and verify Emailit webhooks.
- [Send email with Next.js](https://emailit.com/docs/frameworks/nextjs.md): Send email from Next.js route handlers and server actions with the Emailit Node.js SDK, keep the API key server-side and verify webhooks.
- [Send email with Node.js](https://emailit.com/docs/frameworks/nodejs.md): Send email from Node.js with the @emailit/node SDK or Nodemailer over SMTP, and verify Emailit webhooks in an Express route.
- [Send email with Nuxt](https://emailit.com/docs/frameworks/nuxt.md): Send email from a Nuxt server API route with the Emailit Node.js SDK, keep the key in private runtimeConfig and verify webhooks with h3.
- [Send email with PHP](https://emailit.com/docs/frameworks/php.md): Send email from any PHP app with the emailit/emailit-php SDK, plain cURL or PHPMailer over SMTP, and verify Emailit webhook signatures.
- [Send email with Python](https://emailit.com/docs/frameworks/python.md): Send email from Python with the emailit SDK, Django's SMTP backend or smtplib, and verify Emailit webhooks in Flask or Django.
- [Send email with Ruby on Rails](https://emailit.com/docs/frameworks/rails.md): Deliver Action Mailer email through Emailit with the emailit gem or SMTP settings, call the API directly, and verify Emailit webhooks in Rails.
- [Send WordPress email with Emailit](https://emailit.com/docs/frameworks/wordpress.md): Route WordPress, WooCommerce and contact form email through Emailit SMTP with WP Mail SMTP or a small plugin, using an API key as the password.
- [Emailit for ChatGPT](https://emailit.com/docs/mcp/chatgpt.md): Connect ChatGPT to Emailit with the Emailit plugin to send email, manage domains and contacts, and run campaigns from a chat.
- [Emailit for Claude](https://emailit.com/docs/mcp/claude.md): Connect Claude on claude.ai, Desktop and mobile with the Emailit connector, and Claude Code with the Emailit plugin or claude mcp add.
- [Emailit for Codex](https://emailit.com/docs/mcp/codex.md): Connect OpenAI Codex to Emailit with the Emailit plugin or codex mcp add, then build and test email features from the agent.
- [Emailit for Cursor](https://emailit.com/docs/mcp/cursor.md): Add Emailit to Cursor with one click or the Emailit plugin, then send email, set up domains and debug deliveries from the agent.
- [Emailit for Grok](https://emailit.com/docs/mcp/grok.md): Connect Grok to Emailit on grok.com, in the Grok Build CLI with the Emailit plugin, or from the xAI API as a remote MCP tool.
- [Emailit MCP server](https://emailit.com/docs/mcp.md): Connect ChatGPT, Claude, Cursor, Codex, Grok and other AI tools to Emailit with the hosted MCP server, OAuth sign-in and the full API v2 as tools.
- [Run the MCP server locally](https://emailit.com/docs/mcp/local-server.md): Run the open-source @emailit/emailit-mcp package over stdio or local HTTP with an API key, and configure Claude, Cursor and VS Code to use it.
- [Connect other MCP clients](https://emailit.com/docs/mcp/other-clients.md): Add the hosted Emailit MCP server to VS Code, Windsurf, Zed or any client that supports remote Streamable HTTP servers, with OAuth or an API key.
- [Emailit plugins and skills](https://emailit.com/docs/mcp/plugins-and-skills.md): The official Emailit plugin for ChatGPT, Codex, Claude Code, Cursor and Grok bundles the hosted MCP server with skills and a rule that keeps secrets out of code.
- [MCP tool reference](https://emailit.com/docs/mcp/tools.md): Every tool on the hosted Emailit MCP server, grouped by toolset, with its kind, required scope, role requirement and arguments.
- [Toolsets and read-only mode](https://emailit.com/docs/mcp/toolsets.md): Load only the Emailit MCP tools you need with toolsets, or hide every write tool with read-only mode, through URL options or headers.
- [MCP troubleshooting](https://emailit.com/docs/mcp/troubleshooting.md): Fix common problems with the Emailit MCP server, from sign-in and missing scopes to wrong workspaces, Admin-only tools and clients that load too many tools.
- [Workspaces and permissions](https://emailit.com/docs/mcp/workspaces-and-permissions.md): How MCP connections reach workspaces, the per-call workspace argument, roles and Admin-only tools, sending and full scopes, tokens and revoking access.
- [SDKs and libraries](https://emailit.com/docs/sdks.md): Official Emailit libraries for Node.js, PHP, Laravel, Python, Ruby, Go, Java, .NET and Rust, plus the MCP package and how to call the API over plain HTTP.

## API reference

- [Authentication](https://emailit.com/docs/api-reference/authentication.md): Authenticate API requests with a Bearer API key or OAuth access token, choose full or sending scope, restrict keys to a domain and handle auth errors.
- [All endpoints](https://emailit.com/docs/api-reference/endpoints.md): Every Emailit API v2 endpoint in one place, grouped by resource, with its HTTP method, path, the API key scope it needs and a link to its reference.
- [Errors](https://emailit.com/docs/api-reference/errors.md): How the Emailit API reports errors. Response body formats, HTTP status codes and what they mean, and fixes for the error messages you'll see most.
- [Filtering and sorting](https://emailit.com/docs/api-reference/filtering.md): Filter and sort API list endpoints with key.condition=value query parameters, match and order. Every condition and filterable field per resource.
- [Idempotency](https://emailit.com/docs/api-reference/idempotency.md): Retry email sends safely with the Idempotency-Key header. Which endpoints support it, key format and scope, the 24-hour replay window and its errors.
- [API reference](https://emailit.com/docs/api-reference.md): The Emailit REST API at a glance. Base URL, authentication, JSON requests and responses, object IDs, versioning and every resource you can manage.
- [Pagination](https://emailit.com/docs/api-reference/pagination.md): Page through Emailit API list endpoints with page and limit, read next_page_url, handle the per_page and offset formats and the email and event time windows.
- [Rate limits](https://emailit.com/docs/api-reference/rate-limits.md): How Emailit limits sending per workspace, the ratelimit headers on every send, what a 429 looks like, other endpoint limits and how to retry with backoff.
- [Versioning](https://emailit.com/docs/api-reference/versioning.md): The Emailit API is on version 2. How the version is set, what changes without a new version, the deprecated v1 API and the move to prefixed object IDs.
- [Emails API](https://emailit.com/docs/api-reference/emails.md): Send email, look up messages and their content, and schedule, cancel, retry or forward them.
- [Domains API](https://emailit.com/docs/api-reference/domains.md): Add sending domains, read their DNS records and verification status, and verify them.
- [DMARC reports API](https://emailit.com/docs/api-reference/dmarc.md): Read aggregate and forensic DMARC reports for a sending domain, or upload your own.
- [API keys API](https://emailit.com/docs/api-reference/api-keys.md): Create, list, rename and revoke the API keys of a workspace.
- [Audiences API](https://emailit.com/docs/api-reference/audiences.md): Manage subscriber lists used by campaigns and sign-up forms.
- [Subscribers API](https://emailit.com/docs/api-reference/audiences/subscribers.md): Add, update and remove the subscribers of an audience.
- [Contacts API](https://emailit.com/docs/api-reference/contacts.md): Manage contact profiles and custom fields, in bulk or one at a time.
- [Campaigns API](https://emailit.com/docs/api-reference/campaigns.md): Create campaigns, choose their audiences, and send or schedule them.
- [Automations API](https://emailit.com/docs/api-reference/automations.md): Build workflows from triggers and steps, run them, and inspect their runs.
- [Forms API](https://emailit.com/docs/api-reference/forms.md): Create sign-up forms, publish them, and rotate their public token.
- [Templates API](https://emailit.com/docs/api-reference/templates.md): Create template versions, publish one per alias, and use them when sending.
- [Suppressions API](https://emailit.com/docs/api-reference/suppressions.md): Read and manage the addresses Emailit will not send to.
- [Webhooks API](https://emailit.com/docs/api-reference/webhooks.md): Register endpoints that receive signed event notifications.
- [Events API](https://emailit.com/docs/api-reference/events.md): Read the event stream behind webhooks: deliveries, bounces, opens and more.
- [Email verification API](https://emailit.com/docs/api-reference/email-verifications.md): Verify a single address in real time.
- [Verification lists API](https://emailit.com/docs/api-reference/email-verifications/lists.md): Verify up to 10,000 addresses at once and export the results.
- [Email events](https://emailit.com/docs/webhooks/events/email.md): The lifecycle of every outgoing and inbound email, from acceptance to delivery, opens, clicks and unsubscribes.
- [Domain events](https://emailit.com/docs/webhooks/events/domain.md): Sending domains created, updated or deleted.
- [Audience events](https://emailit.com/docs/webhooks/events/audience.md): Audiences created, updated or deleted.
- [Subscriber events](https://emailit.com/docs/webhooks/events/subscriber.md): Contacts added to, changed in, added back to or removed from an audience.
- [Contact events](https://emailit.com/docs/webhooks/events/contact.md): Contacts created, updated or deleted.
- [Campaign events](https://emailit.com/docs/webhooks/events/campaign.md): Campaigns created, changed, scheduled, sent, canceled, archived or deleted.
- [Template events](https://emailit.com/docs/webhooks/events/template.md): Template versions created, updated, published or deleted.
- [Suppression events](https://emailit.com/docs/webhooks/events/suppression.md): Suppressions created, updated or deleted.
- [Verification events](https://emailit.com/docs/webhooks/events/email-verification.md): Single addresses verified through the API, and each address in a verification list as it finishes.
- [Verification list events](https://emailit.com/docs/webhooks/events/email-verification-list.md): Verification lists created and completed.

## Account & billing

- [Connected apps](https://emailit.com/docs/account/connected-apps.md): Review the AI assistants and apps you connected to Emailit with OAuth, change which workspaces each one can use, and revoke access.
- [Your Emailit account](https://emailit.com/docs/account.md): How your personal Emailit account differs from a workspace, what you can change on the Account page, and how sign-up, timezone and support work.
- [Notification emails](https://emailit.com/docs/account/notification-emails.md): Every email Emailit sends you about your account, workspaces, domains, webhooks, sending health and billing, who receives each one and how to control it.
- [Sign-in and account security](https://emailit.com/docs/account/sign-in-and-security.md): How signing in to Emailit works, from emailed one-time codes to passkeys, plus how to reset your password, change your email and keep your account safe.
- [Two-factor authentication and passkeys](https://emailit.com/docs/account/two-factor-and-passkeys.md): Turn on an authenticator app with recovery codes, add Touch ID, Face ID or security-key passkeys, and regain access if you lose your device.
- [Add-ons and services](https://emailit.com/docs/billing/add-ons.md): Extend any Emailit plan with the Data retention add-on, dedicated IPs, a deliverability consultation, or the non-profit and student discount.
- [AppSumo licenses](https://emailit.com/docs/billing/appsumo.md): Redeem an Emailit AppSumo license, see what each tier includes, how it stacks with your plan and bonuses, and what upgrades, downgrades and refunds do.
- [Auto-refill and credit alerts](https://emailit.com/docs/billing/auto-refill.md): Have Emailit buy credits automatically when your balance runs low, choose who gets refill, low-balance and invoice emails, and understand the refill rules.
- [Credits](https://emailit.com/docs/billing/credits.md): How Emailit credits work: what each action costs, included vs purchased credits, monthly resets, buying credits, the Billable usage tab and running out.
- [Billing](https://emailit.com/docs/billing.md): How Emailit billing works, from plans and monthly credits to purchased credits, auto-refill and invoices, and who in a workspace can change it.
- [Invoices and billing details](https://emailit.com/docs/billing/invoices.md): Find and download Emailit invoices, set the billing email and invoice language, add your billing address and tax ID, and manage the card on file.
- [Plans](https://emailit.com/docs/billing/plans.md): Compare Emailit's Pay as you go, Pro, Business and Custom plans, switch to yearly billing, upgrade or downgrade a workspace and see what changes when you do.
- [Data retention](https://emailit.com/docs/data-retention.md): How long Emailit keeps message contents, activity, logs and analytics on each plan, how to set custom windows, and what stops working after deletion.
- [Limits and quotas](https://emailit.com/docs/limits.md): Every Emailit limit in one place, from per-second and daily sending limits and automatic increases to plan quotas, message size and dashboard limits.
- [Partner program](https://emailit.com/docs/programs/partners.md): The Emailit partner program for agencies, consultants and SaaS platforms: how to apply, commission rates, payouts, client bonuses and the partner directory.
- [Priority migration](https://emailit.com/docs/programs/priority-migration.md): Get Emailit engineers to move your domains, templates, suppressions and webhooks from another email provider, usually within one business day.
- [Refer a friend](https://emailit.com/docs/programs/referrals.md): Share your Emailit referral link so friends get bonus monthly credits, and earn 5,000 credits per qualified friend plus 10% of the credits they buy.
- [Security and compliance](https://emailit.com/docs/security.md): How Emailit protects your account and data, from EU infrastructure, GDPR and retention controls to roles, 2FA, scoped API keys, signed webhooks and OAuth.
- [Workspaces](https://emailit.com/docs/workspaces.md): A workspace holds your domains, API keys, emails, contacts, members and billing. Learn to create and switch workspaces, sandbox mode and per-workspace limits.
- [Invite people to a workspace](https://emailit.com/docs/workspaces/invitations.md): Add teammates to an Emailit workspace with an email invitation or a 24-hour invite code, cancel invitations, and fix expired or wrong-account links.
- [Members and roles](https://emailit.com/docs/workspaces/members-and-roles.md): What workspace Owners, Admins and Members can do in Emailit, how to change a member's role or remove them, and how AppSumo member caps work.
- [Production access (workspace verification)](https://emailit.com/docs/workspaces/production-access.md): New Emailit workspaces start in sandbox mode. Learn the sandbox limits, how to request production access, how review works and how to get approved quickly.
- [Workspace requests](https://emailit.com/docs/workspaces/requests.md): Ask the Emailit team for production access, a custom plan or a dedicated IP, follow the conversation, and request higher sending limits from the Dashboard.
- [Workspace settings](https://emailit.com/docs/workspaces/settings.md): A tour of Workspace > Settings: general settings, members, custom fields, data retention, automatic suppression and requests, and which ones need an admin.

## Resources

- [Bounce categories](https://emailit.com/docs/dictionary/bounce-categories.md): Hard and soft bounces grouped by cause, with typical SMTP codes, how Emailit classifies each one, its effect on suppressions and what to do about it.
- [DNS records for email](https://emailit.com/docs/dictionary/dns-records.md): Syntax and examples for MX, TXT, SPF, DKIM, DMARC, CNAME, PTR, BIMI, MTA-STS and TLS-RPT records, plus the exact records Emailit asks you to publish.
- [Email headers](https://emailit.com/docs/dictionary/email-headers.md): What the common email headers do, from From and Reply-To to DKIM-Signature and List-Unsubscribe, and which ones Emailit adds, rewrites or removes when it sends.
- [Enhanced status codes](https://emailit.com/docs/dictionary/enhanced-status-codes.md): RFC 3463 enhanced status codes such as 5.1.1, 4.7.0 and 5.7.26 explained, with the usual cause behind each and what to change before you send again.
- [Email dictionary](https://emailit.com/docs/dictionary.md): Reference tables for SMTP reply codes, enhanced status codes, email headers, DNS records and bounce categories, and how Emailit handles each one.
- [SMTP reply codes](https://emailit.com/docs/dictionary/smtp-reply-codes.md): What each SMTP reply code means, whether it's temporary or permanent, how Emailit handles it, and the replies Emailit's SMTP relay sends to your app.
- [Why do I get 402 Insufficient credits?](https://emailit.com/docs/kb/402-insufficient-credits.md): Fix 402 Insufficient credits errors from the Emailit API by buying credits, turning on auto-refill or waiting for your monthly credits to reset.
- [Why do I get 403 unverified_workspace_recipient?](https://emailit.com/docs/kb/403-unverified-workspace-recipient.md): New workspaces can only email their members until production access is approved. Learn why the API returns 403 and how to get verified.
- [Why do I get 429 Rate limit exceeded?](https://emailit.com/docs/kb/429-rate-limit-exceeded.md): Handle 429 responses from the Emailit API. Learn the per-second and daily sending limits, the rate-limit headers and how to request higher limits.
- [Why can't I send my campaign?](https://emailit.com/docs/kb/campaign-send-blocked.md): Fix campaigns that won't send. Covers unverified workspaces, a disabled Send button, missing audiences, past schedule times and held campaign emails.
- [Can I send from a Gmail, Yahoo or Outlook address?](https://emailit.com/docs/kb/cannot-send-from-gmail-or-free-domain.md): Emailit only sends from domains you verify with DNS records, so free addresses like @gmail.com can't be used as From. Use your own domain and a Reply-To.
- [Why does my tracking CNAME fail on Cloudflare?](https://emailit.com/docs/kb/cloudflare-proxy-breaks-tracking-cname.md): A proxied (orange cloud) Cloudflare record hides your tracking CNAME, so Emailit can't verify it. Switch the record to DNS only to fix it.
- [Why did my contacts import fail?](https://emailit.com/docs/kb/contacts-import-failed.md): Fix contact imports that fail or bring in fewer contacts than expected. Covers the 2,500-row limit, invalid emails, custom fields and audience caps.
- [Why didn't my monthly credits reset?](https://emailit.com/docs/kb/credits-did-not-reset.md): Included credits reset on your billing date for monthly subscriptions and on the 1st of the month (UTC) for everyone else. Unused credits don't roll over.
- [How do I delete my account or workspace?](https://emailit.com/docs/kb/delete-account-or-workspace.md): Account and workspace deletion aren't self-service in Emailit. Learn what to switch off yourself and how to ask support to delete your data.
- [Why are my DNS records not verifying?](https://emailit.com/docs/kb/dns-records-not-verifying.md): Fix SPF, DKIM and return-path records that stay Missing or Invalid. Covers doubled host names, extra MX records, wrong zones and propagation delays.
- [Why did I get a "Sending domain is no longer verified" email?](https://emailit.com/docs/kb/domain-no-longer-verified-email.md): Emailit re-checks DNS daily. If SPF, DKIM or the return-path record breaks, the domain is unverified and sending stops until you fix it.
- [Why is my domain pending verification?](https://emailit.com/docs/kb/domain-pending-review-new-domain.md): On Pay as you go, domains registered in the last 30 days need a manual review before they can send, even when every DNS record is correct.
- [Why are my emails sent twice?](https://emailit.com/docs/kb/duplicate-emails-sent.md): Find out where duplicate emails come from and stop them with the Idempotency-Key header, which makes retried API requests safe.
- [Why didn't my email arrive?](https://emailit.com/docs/kb/email-not-delivered-checklist.md): A step-by-step checklist for emails that never reached the recipient. Find the email, read its status and follow the fix for that status.
- [What does the Attempted status mean?](https://emailit.com/docs/kb/email-status-attempted.md): Attempted means the receiving server temporarily refused your email. Emailit retries for about 21 hours before it gives up and marks it bounced.
- [Why is my email held?](https://emailit.com/docs/kb/email-status-held.md): Held emails were stopped before delivery because of a spam score, missing credits, a paused domain or a suspended workspace. Find the reason and resend.
- [Why is my email stuck in Accepted or Scheduled?](https://emailit.com/docs/kb/email-stuck-in-scheduled-or-accepted.md): Accepted emails normally leave within seconds and scheduled ones at their send time. Find out what delays them and when to cancel, reschedule or resend.
- [Why are my emails going to spam?](https://emailit.com/docs/kb/emails-going-to-spam.md): Emails marked Delivered can still land in the spam folder. Check authentication, DMARC, content, list quality and volume to improve inbox placement.
- [How do I meet Gmail and Yahoo bulk sender requirements?](https://emailit.com/docs/kb/gmail-yahoo-bulk-sender-requirements.md): Gmail, Yahoo and Outlook require SPF, DKIM, DMARC, one-click unsubscribe and low spam rates from bulk senders. Here's how to meet each rule with Emailit.
- [What's the difference between a hard bounce and a soft bounce?](https://emailit.com/docs/kb/hard-bounce-vs-soft-bounce.md): Hard bounces are permanent refusals and end as Bounced. Soft bounces are temporary, show as Attempted and are retried for about 21 hours.
- [How are credits charged per recipient?](https://emailit.com/docs/kb/how-credits-are-charged-per-recipient.md): Each recipient in to, cc and bcc costs one credit, charged when Emailit accepts the email. Learn how API, SMTP, campaigns, retries and forwards are counted.
- [Why does my workspace invitation say it's invalid or expired?](https://emailit.com/docs/kb/invitation-link-expired.md): Fix workspace invitation links and invite codes that don't work. Email invites last 7 days, invite codes 24 hours, and both need the right account.
- [I lost my two-factor authentication device. How do I sign in?](https://emailit.com/docs/kb/lost-two-factor-device.md): Sign in without your authenticator app using a passkey or a recovery code, then set up two-factor again. If you have neither, contact support.
- [Do I need to change my SPF record for Emailit?](https://emailit.com/docs/kb/multiple-spf-records.md): Emailit's SPF record lives on its own subdomain, so you don't edit your root SPF. Here's how to fix duplicate SPF records if you have them anyway.
- [Why are opens and clicks not tracked?](https://emailit.com/docs/kb/opens-and-clicks-not-tracked.md): Open and click tracking needs a verified tracking CNAME and tracking turned on. Fix missing loaded and clicked events for API, SMTP and campaign mail.
- [Can I get a refund?](https://emailit.com/docs/kb/refund-policy.md): Your first credit purchase is fully refundable within 30 days if you've sent up to 1,000 emails. Learn what isn't refundable and how to ask.
- [Should I send from my root domain or a subdomain?](https://emailit.com/docs/kb/root-domain-or-subdomain.md): Choose between acme.com and a subdomain like mail.acme.com for sending. Subdomains separate reputation but each one needs its own verification.
- [Why does SMTP return 530 From domain not verified?](https://emailit.com/docs/kb/smtp-530-from-domain-not-verified.md): Fix "530 From/Sender domain is not verified for this workspace" and "API key is restricted to sending domain" errors from Emailit SMTP.
- [Why does SMTP return 535 Authentication failed?](https://emailit.com/docs/kb/smtp-535-authentication-failed.md): Fix "535 Authentication failed" from smtp.emailit.com. The SMTP password must be an active Emailit API key, not your account password.
- [Why does my SMTP connection time out?](https://emailit.com/docs/kb/smtp-connection-timeout-port-25.md): Fix SMTP connections to smtp.emailit.com that hang or time out, usually because your network or cloud provider blocks port 25.
- [Why do I get TLS errors when connecting to SMTP?](https://emailit.com/docs/kb/smtp-tls-errors.md): Fix SSL and TLS handshake errors with smtp.emailit.com, such as "wrong version number", certificate name mismatches and STARTTLS failures.
- [How do I test sending before my workspace is verified?](https://emailit.com/docs/kb/test-sending-before-production-access.md): Unverified workspaces can send to their members' account emails. Use that to test the API, SMTP, templates and campaigns while production access is reviewed.
- [How do I transfer ownership of a workspace?](https://emailit.com/docs/kb/transfer-workspace-ownership.md): Workspace ownership can't be transferred from the dashboard. Make the new person an admin, then ask support to move ownership.
- [Why is the unsubscribe link missing from my campaign?](https://emailit.com/docs/kb/unsubscribe-link-missing.md): Fix the "Missing unsubscribe link!" warning and links that show {{unsubscribe_url}} as text. Learn how unsubscribe works in campaigns and API mail.
- [Why was my webhook endpoint disabled?](https://emailit.com/docs/kb/webhook-endpoint-disabled.md): Emailit disables a webhook after 3 days of continuous delivery failures. Find out why deliveries failed, re-enable the endpoint and resend events.
- [Why doesn't my webhook signature match?](https://emailit.com/docs/kb/webhook-signature-mismatch.md): Fix webhook signature verification failures. Sign the raw body with the full whsec_ secret and the X-Emailit-Timestamp value.
- [Why was my email suppressed?](https://emailit.com/docs/kb/why-was-my-email-suppressed.md): A suppressed email wasn't sent because the address is on your suppression list. Learn why addresses get added and how to safely remove one.

## Optional

- [Changelog](https://emailit.com/docs/changelog/): product updates
- [Glossary](https://emailit.com/docs/glossary/): definitions of Emailit and email terms