The universal email router.
Open-source infrastructure to connect, route, and orchestrate email across providers.

Docs • Website • NPM • Twitter • Contact

🚨 We’re looking for OSS Maintainers & Contributors!
Help shape the future of email infrastructure.
→ Get involved

CourierX is a pluggable email router for teams that want freedom from vendor lock-in.
Instead of building around a single provider, you get a unified API that works across many.

• 🔌 Multi-provider support → SendGrid, SES, Postmark, Mailgun, Gmail, and more
• 🎛 Smart routing engine → Cost-aware, deliverability-aware, rule-based
• 📊 Unified observability → Logs, suppressions, analytics in one place
• 🏗 Multi-tenant ready → Workspaces, isolation, security built-in
• 👐 OSS & extensible → Add new providers, swap logic, or self-host

Think of it as nginx for your outbound email.

This GitHub org contains all official CourierX projects:

• courierx-backend → Core API + routing engine
• courierx-packages → TypeScript SDKs & utilities
• courierx-docs → Documentation site (docs.courierx.dev)
• courierx-examples → Integration demos & starter kits

Future growth:

• courierx-dashboard → Service dashboard hosted at courierx.dev
• courierx-integrations → More provider & third-party connectors

📖 The fastest way to start is with the docs → docs.courierx.dev

Or install the client directly:

npm install @courierx/client

import { CourierX } from "@courierx/client";

const cx = new CourierX({ apiKey: process.env.COURIERX_KEY });

await cx.send({
  to: "hello@example.com",
  subject: "Welcome to CourierX",
  body: "Your email router is live 🚀"
});

We’re building CourierX in the open, and we’re always looking for collaborators:

• 🛠 Contribute code → PRs, new provider adapters, bug fixes
• 🧪 Test & validate → Help battle-test across providers and edge cases
• 📢 Spread the word → Share CourierX with your team or community

👉 See our Contributing Guide to get started.

• 📖 Docs site → doc.courierx.dev
• 🌐 Main site → courierx.dev (future service dashboard)

Docs include:

• Getting Started
• Provider Integrations
• API Reference
• Self-hosting Guide
• Roadmap

• 💡 Issues → Use GitHub Issues per repo
• 🗣 Discussions → Coming soon
• 📧 Email → support@courierx.dev
• 🐦 Twitter → @Usecourierx

CourierX is licensed under the MIT License.

Built with ❤️ by the CourierX community · Join us