# Inboundr

> Email infrastructure for developers and AI agents — receive and thread real email over MCP or a REST API.

Every page below is also available as markdown by appending `.md` to its
URL. `llms-full.txt` contains the entire documentation in one file.

- [Full documentation, one file](https://docs.inboundr.net/llms-full.txt)
- [Console](https://inboundr.net/console): sign in, manage domains and API keys

## Start here

- [Meet Inboundr](https://docs.inboundr.net/introduction.md): Email was built for people. Inboundr rebuilds the receiving half for software — and for the agents you put in front of it.
- [Quickstart](https://docs.inboundr.net/quickstart.md): Add a domain, create an API key, and receive your first email in a few minutes.

## How Inboundr works

- [The mental model](https://docs.inboundr.net/concepts/model.md): Five objects, one flow. Understand how a message travels from the sender's outbox to your code.
- [Domains](https://docs.inboundr.net/concepts/domains.md): A domain is an email identity you own. Verify it once to receive mail on every address.
- [Addresses & routing](https://docs.inboundr.net/concepts/addresses.md): How Inboundr decides what happens to an incoming message — explicit routes, store-only inboxes, and catch-all.
- [Endpoints](https://docs.inboundr.net/concepts/endpoints.md): An endpoint is a webhook destination. Route addresses or a domain's catch-all to it to receive mail in real time.
- [Shield rules](https://docs.inboundr.net/concepts/shield.md): Allow, block, or reroute mail as it arrives — before it is stored or delivered.
- [Emails & threads](https://docs.inboundr.net/concepts/emails-and-threads.md): How Inboundr parses, stores, and groups messages into conversations.

## Recipes

- [Receiving email](https://docs.inboundr.net/guides/receiving-email.md): Two ways to receive mail: real-time webhooks, or read on demand from stored inboxes.
- [Build an email agent](https://docs.inboundr.net/guides/build-an-agent.md): Give an AI agent its own address and let it read and triage its inbox over MCP.

## Webhooks

- [Webhooks overview](https://docs.inboundr.net/webhooks/overview.md): The email.received event — its payload, headers, and how to respond.
- [Verifying signatures](https://docs.inboundr.net/webhooks/verifying-signatures.md): Confirm a webhook really came from Inboundr by validating its HMAC signature.
- [Retries & delivery](https://docs.inboundr.net/webhooks/retries.md): How Inboundr retries failed webhook deliveries, and how to make your handler robust.

## Agents & MCP

- [MCP Server](https://docs.inboundr.net/integrations/mcp.md): Connect an AI agent to its inbox with the native Model Context Protocol server — read, thread, and filter as first-class tools.

## Account

- [Billing](https://docs.inboundr.net/billing.md): Plans, monthly receiving allotment, and metered overage.

## API reference — Reference

- [API introduction](https://docs.inboundr.net/api-reference/introduction.md): Base URL, conventions, and object ids for the Inboundr REST API.
- [Authentication](https://docs.inboundr.net/api-reference/authentication.md): Authenticate every request with a bearer API key.
- [Pagination](https://docs.inboundr.net/api-reference/pagination.md): Cursor-based pagination for list endpoints.
- [Rate limits](https://docs.inboundr.net/api-reference/rate-limits.md): One request budget per account, shared across everything you build on Inboundr.
- [Errors](https://docs.inboundr.net/api-reference/errors.md): Status codes and error shapes returned by the API.

## API reference — Domains

- [List all domains](https://docs.inboundr.net/api-reference/domains/list.md): GET https://inboundr.net/api/v1/domains
- [Create a domain](https://docs.inboundr.net/api-reference/domains/create.md): POST https://inboundr.net/api/v1/domains
- [Get domain by ID](https://docs.inboundr.net/api-reference/domains/get.md): GET https://inboundr.net/api/v1/domains/{id}
- [Update catch-all](https://docs.inboundr.net/api-reference/domains/update.md): PATCH https://inboundr.net/api/v1/domains/{id}
- [Delete domain](https://docs.inboundr.net/api-reference/domains/delete.md): DELETE https://inboundr.net/api/v1/domains/{id}

## API reference — Email Addresses

- [List all addresses](https://docs.inboundr.net/api-reference/addresses/list.md): GET https://inboundr.net/api/v1/addresses
- [Create an address](https://docs.inboundr.net/api-reference/addresses/create.md): POST https://inboundr.net/api/v1/addresses
- [Get address by ID](https://docs.inboundr.net/api-reference/addresses/get.md): GET https://inboundr.net/api/v1/addresses/{id}
- [Update an address](https://docs.inboundr.net/api-reference/addresses/update.md): PATCH https://inboundr.net/api/v1/addresses/{id}
- [Delete an address](https://docs.inboundr.net/api-reference/addresses/delete.md): DELETE https://inboundr.net/api/v1/addresses/{id}

## API reference — Shield Rules

- [List shield rules](https://docs.inboundr.net/api-reference/shield-rules/list.md): GET https://inboundr.net/api/v1/shield-rules
- [Create a shield rule](https://docs.inboundr.net/api-reference/shield-rules/create.md): POST https://inboundr.net/api/v1/shield-rules
- [Get a shield rule](https://docs.inboundr.net/api-reference/shield-rules/get.md): GET https://inboundr.net/api/v1/shield-rules/{id}
- [Update or reorder a shield rule](https://docs.inboundr.net/api-reference/shield-rules/update.md): PUT https://inboundr.net/api/v1/shield-rules/{id}
- [Reorder shield rules](https://docs.inboundr.net/api-reference/shield-rules/reorder.md): PUT https://inboundr.net/api/v1/shield-rules
- [Delete a shield rule](https://docs.inboundr.net/api-reference/shield-rules/delete.md): DELETE https://inboundr.net/api/v1/shield-rules/{id}

## API reference — Endpoints

- [List all endpoints](https://docs.inboundr.net/api-reference/endpoints/list.md): GET https://inboundr.net/api/v1/endpoints
- [Create an endpoint](https://docs.inboundr.net/api-reference/endpoints/create.md): POST https://inboundr.net/api/v1/endpoints
- [Get endpoint by ID](https://docs.inboundr.net/api-reference/endpoints/get.md): GET https://inboundr.net/api/v1/endpoints/{id}
- [Update an endpoint](https://docs.inboundr.net/api-reference/endpoints/update.md): PATCH https://inboundr.net/api/v1/endpoints/{id}
- [Delete an endpoint](https://docs.inboundr.net/api-reference/endpoints/delete.md): DELETE https://inboundr.net/api/v1/endpoints/{id}
- [Test an endpoint](https://docs.inboundr.net/api-reference/endpoints/test.md): POST https://inboundr.net/api/v1/endpoints/{id}/test

## API reference — Emails

- [List emails](https://docs.inboundr.net/api-reference/emails/list.md): GET https://inboundr.net/api/v1/emails
- [Get email by ID](https://docs.inboundr.net/api-reference/emails/get.md): GET https://inboundr.net/api/v1/emails/{id}
- [Delete an email](https://docs.inboundr.net/api-reference/emails/delete.md): DELETE https://inboundr.net/api/v1/emails/{id}
- [Retry email delivery](https://docs.inboundr.net/api-reference/emails/retry.md): POST https://inboundr.net/api/v1/emails/{id}/retry

## API reference — Threads

- [Get thread by ID](https://docs.inboundr.net/api-reference/threads/get.md): GET https://inboundr.net/api/v1/threads/{id}

## API reference — Attachments

- [Download attachment](https://docs.inboundr.net/api-reference/attachments/download.md): GET https://inboundr.net/api/v1/emails/{id}/attachments/{index}