# Mailmanny

> Mailmanny is a Mailchimp-style email marketing platform for small businesses and the developers who build their apps: campaigns, audiences and automations in the web app, plus a REST API (JSON over HTTPS), a Node.js SDK and a CLI. From code you send transactional email written in React Email, add people to audiences (double opt-in by default) and track events that start automations. The SDK is Resend-compatible: `emails.send` takes the same fields and returns the same `{ data, error }` result.

Set up Mailmanny in an app with an AI agent:

1. A person on the team creates an API key in Settings → API keys (https://www.mailmanny.com/settings/api-keys) and stores it as `MAILMANNY_API_KEY` in the server's environment. Keys start with `mm_live_` and are server-side secrets: the API refuses browser requests.
2. They verify the sending domain first, in Settings → Domains (https://www.mailmanny.com/settings/domains). Mailmanny only sends from verified domains: any other `from` fails with 422 `invalid_from_address`.
3. Install the SDK (Node.js 18.17+, ESM or CommonJS, no runtime dependencies): `npm install mailmanny`. Add `@react-email/render` to send React Email components.
4. The SDK reads `MAILMANNY_API_KEY` (and the optional `MAILMANNY_BASE_URL`) from the environment. Without the SDK, call https://www.mailmanny.com/api/v1 with `Authorization: Bearer $MAILMANNY_API_KEY`.
5. Every SDK method resolves to `{ data, error }` and never throws for API errors. Check `error.name` (stable, e.g. `validation_error`, `rate_limit_exceeded`).

Send an email:

```ts
import { Mailmanny } from "mailmanny";

const mm = new Mailmanny(process.env.MAILMANNY_API_KEY);
const { data, error } = await mm.emails.send({ from: "You <you@your-verified-domain.com>", to: "sam@example.com", subject: "Hello from Mailmanny", html: "<p>It works.</p>" });
```

The docs links below point at each page's Markdown. "Use with AI agents" (https://www.mailmanny.com/docs/ai-agents.md) has a ready-made setup prompt.

## Get started

- [Quickstart](https://www.mailmanny.com/docs.md): Send your first email and add your first subscriber in five minutes.
- [Use with AI agents](https://www.mailmanny.com/docs/ai-agents.md): Point Claude Code, Cursor, Codex or any agent at the docs and let it set Mailmanny up.
- [Authentication & API keys](https://www.mailmanny.com/docs/authentication.md): Bearer keys, permissions and audience keys.
- [API reference](https://www.mailmanny.com/docs/api-reference.md): Every endpoint on one page.

## Guides

- [Sending email](https://www.mailmanny.com/docs/sending.md): Transactional email with React Email, HTML or a saved template.
- [Contacts & audiences](https://www.mailmanny.com/docs/contacts.md): Add, update and remove people, Mailchimp-style.
- [Tags](https://www.mailmanny.com/docs/tags.md): Label contacts from your code.
- [Events & automations](https://www.mailmanny.com/docs/events.md): Start automations when something happens in your app.
- [Templates & the CLI](https://www.mailmanny.com/docs/templates.md): Push your React Email folder with one command.

## Reference

- [Errors](https://www.mailmanny.com/docs/errors.md): Every error name, and what to do about it.
- [Rate limits](https://www.mailmanny.com/docs/rate-limits.md): Request limits, headers and sending caps.
- [Idempotency](https://www.mailmanny.com/docs/idempotency.md): Retry safely without sending twice.

## Policies

- [Compliance requirements](https://www.mailmanny.com/docs/compliance.md): Opt-in, unsubscribe, your address, and what gets sending paused.

## SDK

- [SDK README](https://www.mailmanny.com/sdk/README.md): Every method of the `mailmanny` Node.js SDK and CLI, with examples.
- [mailmanny on npm](https://www.npmjs.com/package/mailmanny): The package: `npm install mailmanny`.
- [Source on GitHub](https://github.com/Mailmanny/mailmanny-node): The SDK and CLI source (MIT).

## Optional

- [All docs in one file](https://www.mailmanny.com/llms-full.txt): Every page above, concatenated, for agents that read everything up front.
- [Pricing](https://www.mailmanny.com/pricing): Plans and sending limits. API events need Standard or Pro.
- [Developers overview](https://www.mailmanny.com/developers): What the API, SDK and CLI are for.