# MarleyFetch

> MarleyFetch is an email API in front of the SMTP account you already have (Gmail, Google Workspace, Microsoft 365, Amazon SES, SendGrid or any SMTP host). One HTTPS call sends an email; queues, retries, batching and per-connection rate limits are handled for you.

Base URL: `https://api.marleyfetch.com/v1`. Authenticate with `Authorization: Bearer <API key>`; create keys at https://app.marleyfetch.com/tokens. Every page below is plain Markdown.

## Get started

- [Quickstart](https://docs.marleyfetch.com/getting-started.md): Connect an SMTP account, create an API key and send your first email.
- [JavaScript SDK](https://docs.marleyfetch.com/sdk.md): The marleyfetch-sdk package — a zero-dependency, chainable JavaScript/TypeScript client for Node.js, Workers, Vercel, Deno and Bun.

## Guides

- [SMTP connections](https://docs.marleyfetch.com/guides/connections.md): Add the SMTP account MarleyFetch sends through, provider settings, the default connection, quotas and pacing.
- [API keys](https://docs.marleyfetch.com/guides/api-keys.md): Create, scope, rotate and revoke the API keys that authenticate requests.
- [Sending email](https://docs.marleyfetch.com/guides/sending.md): Send a single email with /v1/send or queue it with /v1/enqueue — recipients, HTML, idempotent retries and responses.
- [Batch sending](https://docs.marleyfetch.com/guides/batches.md): Send one message to many recipients with /v1/send/batch, personalise it per recipient and track progress.
- [Audiences](https://docs.marleyfetch.com/guides/audiences.md): Build reusable recipient lists with per-member variables, add members by API or dashboard, and collect sign-ups with a hosted page.
- [Templates](https://docs.marleyfetch.com/guides/templates.md): Save a subject and body once and send it by ID in batches, with {{placeholders}} for personalisation.
- [Forms](https://docs.marleyfetch.com/guides/forms.md): Hosted contact and feedback forms whose submissions are emailed to you through your own connection.

## Reference

- [API reference](https://docs.marleyfetch.com/api/index.md): Every public endpoint, request field and response, generated from the OpenAPI spec.
- [Errors](https://docs.marleyfetch.com/reference/errors.md): Error response shapes, every error code with its cause and fix, and how to retry rate limits.
- [Plans & limits](https://docs.marleyfetch.com/reference/limits.md): What the Free and Pro plans include, and the request limits that apply to everyone.
- [Docs for AI tools](https://docs.marleyfetch.com/ai.md): Machine-readable versions of these docs — llms.txt, llms-full.txt, per-page Markdown and the OpenAPI spec — for coding assistants and LLMs.

## Optional

- [OpenAPI spec](https://docs.marleyfetch.com/openapi.yaml): Machine-readable OpenAPI 3.1 description of every public endpoint.
- [Full documentation](https://docs.marleyfetch.com/llms-full.txt): Every page above plus the OpenAPI spec in a single file.