llms.txt
Compare with other sites' llms.txt files →# Courier
> Courier is the customer messaging platform for humans and AI agents. One API call, CLI command, or MCP tool sends across email, SMS, push, in-app inbox, Slack, and Microsoft Teams, through your providers, with routing, preferences, templates, and delivery tracking handled for you.
Courier is not an email or SMS provider. It orchestrates delivery through providers you connect (SendGrid, Twilio, Firebase FCM, APNs, and others).
## When to use Courier
- Send a transactional or product notification (password reset, receipt, alert, mention) on any channel, or across several with fallback.
- Let users choose which notifications they get and where, with a hosted or embeddable preferences UI.
- Add an in-app notification inbox to a web or mobile app.
- Run a multi-step lifecycle journey (onboarding, re-engagement) with delays, branches, and digests.
- Send a one-off broadcast to a list or audience, now or scheduled.
- Batch many events into one summary message (digest).
- Manage notification templates from code, or let non-engineers edit them in Design Studio.
- Isolate notification content, branding, and preferences per customer (tenants).
Don't use Courier for unsolicited bulk email or SMS; recipients must have opted in.
## How agents should use Courier
- To research, fetch the indexes under "Go deeper" and follow their links. Every docs page has a `.md` variant, and every courier.com page returns markdown for `Accept: text/markdown`.
- To send or configure, read "How to call Courier" first, then the page for the task. Use a Test environment API key until the user says otherwise; test sends appear only in the Test dashboard.
- To act inside an editor, connect the hosted MCP server rather than scripting the REST API by hand.
## How to call Courier
Base URL `https://api.courier.com`. Authenticate with `Authorization: Bearer <API_KEY>`. Keys are plain `pk_...`; Test and Production environments have separate keys.
Send a message:
```bash
curl -X POST https://api.courier.com/send \
-H "Authorization: Bearer $COURIER_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-confirmed-ORD-456" \
-d '{
"message": {
"template": "order-confirmation",
"to": { "user_id": "user_123" },
"data": { "order_id": "ORD-456", "total": "$99.99" }
}
}'
```
`template` is a Design Studio template ID or alias. `to.user_id` is a Courier user; contact details and preferences come from the user record. `data` is the event payload. `Idempotency-Key` makes retries safe.
Node SDK:
```javascript
import Courier from "@trycourier/courier";
const courier = new Courier(); // reads COURIER_API_KEY
const { requestId } = await courier.send.message(
{
message: {
template: "order-confirmation",
to: { user_id: "user_123" },
data: { order_id: "ORD-456", total: "$99.99" },
},
},
{ idempotencyKey: "order-confirmed-ORD-456" }
);
```
Official SDKs: Node.js `npm install @trycourier/courier`, Python `pip install trycourier`, Ruby `gem "trycourier"`, Go `go get github.com/trycourier/courier-go/v4`, Java `com.courier:courier-java`, PHP `composer require trycourier/courier`, C# `dotnet add package TryCourier`. Client-side: `@trycourier/courier-react`, `@trycourier/courier-ui-inbox`, `@trycourier/courier-js`, `@trycourier/courier-react-native`.
- [Send your first message](https://www.courier.com/docs/get-started/send-a-message.md): one send with a Test key, then find it in the logs.
- Server SDKs: [Node.js](https://www.courier.com/docs/sdk-libraries/node.md), [Python](https://www.courier.com/docs/sdk-libraries/python.md), [Go](https://www.courier.com/docs/sdk-libraries/go.md), [Ruby](https://www.courier.com/docs/sdk-libraries/ruby.md), [PHP](https://www.courier.com/docs/sdk-libraries/php.md), [Java](https://www.courier.com/docs/sdk-libraries/java.md), [C#](https://www.courier.com/docs/sdk-libraries/csharp.md). All SDKs: [SDKs overview](https://www.courier.com/docs/sdk-libraries/sdks-overview.md).
- [Send a message](https://www.courier.com/docs/send/overview.md)
- [Message statuses and errors](https://www.courier.com/docs/send/statuses.md)
- [Workspaces and environments](https://www.courier.com/docs/workspaces/overview.md): Test and Production, each with its own API keys.
- [API reference overview](https://www.courier.com/docs/reference/api-overview.md): authentication, request format, idempotency, and pagination.
## Tools for AI agents
Start at [courier.com/agents](https://www.courier.com/agents): coding agents build your messaging, and production AI agents send it.
- Hosted MCP server at `https://mcp.courier.com`. Claude Code: `claude mcp add --transport http courier https://mcp.courier.com --header api_key:YOUR_COURIER_API_KEY`. Cursor, Codex, VS Code: [MCP docs](https://www.courier.com/docs/resources/mcp.md).
- CLI: `npm install -g @trycourier/cli`. [CLI docs](https://www.courier.com/docs/resources/cli.md).
- Courier Skills: `npx skills add trycourier/courier-skills`, or in Claude Code `/plugin marketplace add trycourier/courier-skills` then `/plugin install courier@courier-skills`. [Skills docs](https://www.courier.com/docs/resources/skills.md).
- [Build with AI](https://www.courier.com/docs/get-started/build-with-ai.md): connect a coding agent through MCP, the CLI, or skills.
- [Send from an AI agent](https://www.courier.com/docs/guides/send-from-an-ai-agent.md): let an agent send notifications through the MCP server with a scoped API key.
- Discovery: [MCP server card](https://www.courier.com/docs/.well-known/mcp/server-card.json), [agent card](https://www.courier.com/docs/.well-known/agent-card.json), [skills index](https://www.courier.com/docs/.well-known/agent-skills/index.json).
## Core concepts
- [Sending](https://www.courier.com/docs/send/overview.md): one request handles rendering, routing, preferences, and delivery.
- [Templates](https://www.courier.com/docs/design/templates/overview.md): built in Design Studio or via the API. [Elemental](https://www.courier.com/docs/design/elemental/overview.md) is the JSON content format.
- [Routing](https://www.courier.com/docs/send/routing.md): which channels, in what order, with what fallback.
- [Users and profiles](https://www.courier.com/docs/recipients/overview.md): store contact details once, then send by `user_id`.
- [Preferences](https://www.courier.com/docs/recipients/preferences/overview.md): per-user, per-topic opt-in and channel choice.
- [In-app](https://www.courier.com/docs/in-app/overview.md): inbox, toasts, and preference center for web and mobile SDKs.
- [Journeys](https://www.courier.com/docs/journeys/overview.md): multi-step flows with delays, branches, and digests.
- [Broadcasts](https://www.courier.com/docs/broadcasts/overview.md): one message to a list or audience, now or scheduled.
- [Tenants](https://www.courier.com/docs/tenants/overview.md): per-customer isolation of content, brand, and preferences.
- [Brands](https://www.courier.com/docs/design/brands.md): logo, colors, and footer applied across templates.
## Common tasks
Step-by-step walkthroughs live in the docs [Guides](https://www.courier.com/docs/guides/overview.md) tab.
- Send your first message: [Quickstart](https://www.courier.com/docs/get-started/send-a-message.md)
- Connect a provider (SendGrid, Twilio, FCM, APNs, Slack, and more): [Integrations](https://www.courier.com/docs/integrations/overview.md)
- Create or update a template from code: [Manage templates with the API](https://www.courier.com/docs/design/templates/api.md)
- Add an in-app inbox: [Add the Courier Inbox](https://www.courier.com/docs/in-app/add-an-inbox.md), or for [React](https://www.courier.com/docs/guides/add-an-inbox-to-react.md), [Next.js](https://www.courier.com/docs/guides/add-an-inbox-to-nextjs.md), [Astro](https://www.courier.com/docs/guides/add-an-inbox-to-astro.md)
- Let users manage preferences: [Build a preference center](https://www.courier.com/docs/guides/build-a-preference-center.md)
- Build a multi-step flow (onboarding, reminders, re-engagement): [Build a journey](https://www.courier.com/docs/journeys/build.md)
- Batch events into a digest: [Send a daily digest](https://www.courier.com/docs/guides/send-a-daily-digest.md)
- Get delivery events in your system: [Outbound webhooks](https://www.courier.com/docs/monitor/webhooks/outbound.md)
- Check what happened to a message: [Message logs](https://www.courier.com/docs/monitor/overview.md), [Debug email delivery](https://www.courier.com/docs/guides/debug-delivery.md)
- Handle failures and retries: [Message routing and failover](https://www.courier.com/docs/send/routing.md)
- Move from Test to Production: [Go live](https://www.courier.com/docs/guides/go-live.md)
- Migrate from [Knock](https://www.courier.com/docs/guides/migrate/from-knock.md), [Novu](https://www.courier.com/docs/guides/migrate/from-novu.md), [SuprSend](https://www.courier.com/docs/guides/migrate/from-suprsend.md), [OneSignal](https://www.courier.com/docs/guides/migrate/from-onesignal.md), [Braze](https://www.courier.com/docs/guides/migrate/from-braze.md), or [others](https://www.courier.com/docs/guides/migrate/overview.md).
## Pricing
Per send, not per user, with no seat or channel fees. Developer: free, and includes 10,000 sends a month. Business: $0.005 for every send, including the first 10,000. Enterprise: volume pricing below $0.005. Details: [pricing.md](https://www.courier.com/pricing.md).
## Go deeper
- [Docs index](https://www.courier.com/docs/llms.txt): every documentation page, with a one-line description.
- [Full docs text](https://www.courier.com/docs/llms-full.txt): all documentation in one file.
- [Notification guides](https://www.courier.com/guides/llms.txt): long-form guides at courier.com/guides, separate from the docs Guides tab.
- [Notification recipes](https://www.courier.com/recipes/llms.txt): tested journeys and sends for onboarding, billing, retention, and sign-in, each with copy and Node and Python code.
- [Blog](https://www.courier.com/blog/llms.txt): articles, newest first.
- [Changelog](https://www.courier.com/changelog): what shipped.
Any page on courier.com returns markdown when requested with `Accept: text/markdown`.