> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paubox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Receiving email

> Receive inbound email through the Paubox Email API — provision domains, create mailboxes, and retrieve messages programmatically.

Paubox Receiving lets you accept inbound email through the same Email API you already use to send. Provision a domain, create mailboxes, and pull messages and attachments via REST — no mail server to run.

## How it works

1. **Create a receiving domain.** Each domain is a subdomain of `inbound.paubox.email` (e.g. `support.inbound.paubox.email`). DNS is configured automatically — no records to add.
2. **Create mailboxes.** A mailbox is an address on your domain (e.g. `intake@support.inbound.paubox.email`). Each mailbox has a name and password, with an optional storage quota.
3. **Receive email.** Anyone can send to your mailbox addresses. Messages are stored and available via the API within seconds.
4. **Retrieve messages.** List, read, and download attachments through the API. Cursor-based pagination keeps large mailboxes fast.

## Resources

The receiving surface is organized into three resource groups:

| Resource                                         | Description                                                    |
| :----------------------------------------------- | :------------------------------------------------------------- |
| [Domains](/email-api/receiving/list-domains)     | Provision and manage `*.inbound.paubox.email` subdomains       |
| [Mailboxes](/email-api/receiving/list-mailboxes) | Create and manage mailbox addresses on your domains            |
| [Emails](/email-api/receiving/list-emails)       | List received messages, read content, and download attachments |

## Limits

* Domains per account: contact support for limits above the default.
* Mailboxes per domain: no hard limit; each mailbox consumes storage.
* Email retrieval: paginated, up to 100 per request.
* Attachment download: returns raw bytes; size limited by the original message.