# Email SDK

- [Email SDK](/docs): TypeScript email SDK documentation for production transactional send pipelines across Resend, SMTP, Postmark, SendGrid, Mailgun, AWS SES, and more.
- Getting started
  - [Install](/docs/getting-started/install): Install the SDK package and run the email-sdk CLI.
  - [Quickstart](/docs/getting-started/quickstart): Create a client, send a first transactional email, and verify the CLI path.
- Concepts
  - [Adapter model](/docs/concepts/adapter-model): How Email SDK adapters, routing names, and escape hatches work.
  - [Fallbacks and retries](/docs/concepts/fallbacks-and-retries): Route transactional email through retryable primary adapters and compatible backup adapters.
  - [Hooks](/docs/concepts/hooks): Observe sends without changing adapter code.
- Adapters
  - [Adapters](/docs/adapters): Supported email service adapters and transports.
  - [SDK field support](/docs/adapters/field-support): See which EmailMessage fields Email SDK maps for each adapter.
  - [Resend](/docs/adapters/resend): Configure the fetch-based Resend adapter.
  - [Postmark](/docs/adapters/postmark): Configure the fetch-based Postmark adapter.
  - [SendGrid](/docs/adapters/sendgrid): Configure the Twilio SendGrid Mail Send API adapter.
  - [Cloudflare Email Sending](/docs/adapters/cloudflare): Configure the Cloudflare Email Sending REST API adapter.
  - [AWS SES](/docs/adapters/ses): Configure the AWS SES v2 SendEmail adapter.
  - [Mailgun](/docs/adapters/mailgun): Configure the Mailgun Messages API adapter.
  - [MailerSend](/docs/adapters/mailersend): Configure the MailerSend Email API adapter.
  - [Brevo](/docs/adapters/brevo): Configure the Brevo transactional email adapter.
  - [Mailchimp Transactional](/docs/adapters/mailchimp): Configure the Mailchimp Transactional adapter.
  - [SparkPost](/docs/adapters/sparkpost): Configure the SparkPost Transmissions API adapter.
  - [Loops](/docs/adapters/loops): Configure the Loops transactional email adapter.
  - [Plunk](/docs/adapters/plunk): Configure the Plunk send API adapter.
  - [Mailtrap](/docs/adapters/mailtrap): Configure the Mailtrap Email Sending API adapter.
  - [Cloudflare Email Sending](/docs/adapters/cloudflare): Configure the Cloudflare Email Sending REST API adapter.
  - [Scaleway](/docs/adapters/scaleway): Configure the Scaleway Transactional Email adapter.
  - [ZeptoMail](/docs/adapters/zeptomail): Configure the Zoho ZeptoMail adapter.
  - [MailPace](/docs/adapters/mailpace): Configure the MailPace send API adapter.
  - [SMTP](/docs/adapters/smtp): Configure generic SMTP for PurelyMail or a custom server.
- Plugins
  - [Plugins](/docs/plugins): Built-in plugins and extension points for Email SDK.
  - Built-in
    - [Defaults plugin](/docs/plugins/built-in/defaults): Apply shared message and send-option defaults.
    - [Observability plugin](/docs/plugins/built-in/observability): Emit redacted log, metric, and trace events.
    - [Capture plugin](/docs/plugins/built-in/capture): Record email events in tests.
  - [Community plugins and adapters](/docs/plugins/community): Static registry for third-party Email SDK plugins and provider adapters.
  - [Writing plugins](/docs/plugins/writing-plugins): Create adapter, middleware, and community plugins.
  - [Plugin API](/docs/plugins/api): Type reference for EmailPlugin and EmailSendMiddleware.
- Guides
  - [Guides](/docs/guides): Task-based guides for operating and extending Email SDK.
  - [Production send pipeline](/docs/guides/production-send-pipeline): Combine adapters, validation, retries, fallback routes, observability, tests, and CLI checks.
  - [Test email behavior](/docs/guides/test-email-behavior): Assert sends, retries, fallbacks, and plugin behavior.
  - Build
    - [Create your first plugin](/docs/guides/authoring/create-first-plugin): Build a reusable send policy plugin.
    - [Create an adapter](/docs/guides/authoring/create-adapter): Write your first custom provider adapter.
    - [Publish a community plugin](/docs/guides/authoring/publish-community-plugin): Package and list a third-party Email SDK plugin.
    - [Publish a community adapter](/docs/guides/authoring/publish-community-adapter): Build, publish, and list a third-party provider adapter without making it official.
- Reference
  - [Client](/docs/reference/client): Reference for createEmailClient, send, sendBatch, and adapter helpers.
  - [Message](/docs/reference/message): Reference for EmailMessage, addresses, attachments, headers, and tags.
  - [Adapter contract](/docs/reference/adapter-contract): Exact provider and plugin types for custom Email SDK adapters.
  - [Community registry](/docs/reference/community-registry): Static schema and verification rules for community plugin listings.
  - [Errors](/docs/reference/errors): Reference for Email SDK error classes and retry flags.
  - [CLI](/docs/reference/cli): Reference for the email-sdk command-line smoke test.
- Agents
  - [Agent skill](/docs/agents/skill): Use the repo-local Email SDK skill when agents add or review email integrations.