# AY Inbox

> AY Inbox is a cold email platform. It warms mailboxes, sends cold email at a paced daily volume and brings every reply into one inbox, where Aya, its AI assistant, drafts the answer and offers a meeting time.

AY Inbox runs as a hosted service at https://app.ayinbox.com and as a self-hosted install from the same code. Access to the hosted service is invite only for now: ask at team@ayinbox.com.

Defaults that are on before anyone changes a setting:

- Cold email: at most 50 emails a day per mailbox, with at least 10 minutes between two sends from the same mailbox.
- Warmup: a new mailbox starts at 10 emails a day and adds one a day up to 40.
- A mailbox whose complaint rate reaches 0.1% is taken out of the warmup pool for a week.

The documentation lives at https://docs.ayinbox.com. Its own index is https://docs.ayinbox.com/llms.txt, the full text of every page is https://docs.ayinbox.com/llms-full.txt, and every docs page has a Markdown twin at its path with `.md` in place of the trailing slash.

## For agents

- [Guide for agents](https://ayinbox.com/skill.md): What AY Inbox is, how an agent connects over MCP (or opens its own workspace where agent sign-up is on), what it can do, what waits for a person, the limits and the errors.
- [This page as Markdown](https://ayinbox.com/index.md): The landing page written for an agent to read, with the three steps to start.

## Product

- [Getting started](https://docs.ayinbox.com/guides/): Connect a mailbox, warm it up and send your first campaign.
- [Mailboxes](https://docs.ayinbox.com/guides/mailboxes/): Connect sender accounts and see how they are assigned to workers.
- [Warmup](https://docs.ayinbox.com/guides/warmup/): How warmup threads, placement evidence and pacing work.
- [Campaigns](https://docs.ayinbox.com/guides/campaigns/): Create and send cold outreach campaigns.
- [Unibox](https://docs.ayinbox.com/guides/unibox/): One inbox across every connected mailbox, with labels and threading.
- [Campaign brain](https://docs.ayinbox.com/guides/campaign-brain/): The offer, pricing, proof, links and rules that every AI reply draft reads.
- [Inbox tagging](https://docs.ayinbox.com/guides/inbox-tagging/): Labels every reply as it arrives (Interested, Meeting, Pricing, Not now and more) and keeps automated mail out of the inbox.
- [Inbox agent](https://docs.ayinbox.com/guides/inbox-agent/): Aya drafts a reply to each human reply from the thread, the contact, the campaign step and the brain, for a person to approve.
- [Auto-reply](https://docs.ayinbox.com/guides/auto-reply/): Campaigns that opt in answer a qualifying human reply in the same thread.
- [Calendar booking](https://docs.ayinbox.com/guides/booking/): Offer open times from Cal.com or Calendly and book the one the prospect picks.
- [Deliverability](https://docs.ayinbox.com/guides/deliverability/): Bounce, complaint and spam-placement health, with the thresholds AY Inbox acts on.

## API

- [API overview](https://docs.ayinbox.com/api/): Base URL, conventions and a quickstart.
- [Authentication](https://docs.ayinbox.com/api/authentication/): Authenticate with API keys.
- [Endpoint scope map](https://docs.ayinbox.com/api/endpoints/): Every endpoint, the auth types it accepts and the permission it requires.
- [MCP server](https://docs.ayinbox.com/api/mcp/): Connect an MCP client to AY Inbox.
- [For agents](https://docs.ayinbox.com/api/for-agents/): How an AI agent opens its own workspace with one request (`POST https://api.ayinbox.com/v1/agents/register`), connects over MCP, and how a person takes the workspace over.
- [CLI](https://docs.ayinbox.com/api/cli/): The ayinbox command line interface.

## Learn

- [Email warmup](https://docs.ayinbox.com/learn/email-warmup/): Why warmup exists and how providers read it.
- [SPF, DKIM, and DMARC](https://docs.ayinbox.com/learn/spf-dkim-dmarc/): The three authentication records a cold email sender needs.
- [Cold email rules](https://docs.ayinbox.com/learn/cold-email-rules/): What the main anti-spam laws say about cold email.

## Self-hosting

- [Install](https://docs.ayinbox.com/development/install/): One command installs AY Inbox from published release images.
- [Data control](https://docs.ayinbox.com/development/data-control/): Where each store lives, what is kept and for how long, and how backups work.