# Agent Mail
Give your AI agents their own email address — send and receive at `@basedmail.ai` via API.
Agent Mail lets you create mailboxes for your agents, bots, and workflows. Every mailbox gets a real email address that can send and receive messages — no mail server, no DNS records, no infrastructure required.
Create a Mailbox
## Why Based Is Building This
Agents that can only talk to APIs are limited. The real world still runs on email — customer support, notifications, approvals, reports, onboarding flows, and human-in-the-loop workflows all happen over email.
For agents to participate in commerce and communication at scale, they need an email identity:
* **Agents need to reach humans where they are.** Not everyone has an API. Email is the universal communication protocol — every person, every business, every system can receive an email.
* **Email is a trigger for agentic workflows.** An incoming email can kick off research, generate a report, place a trade, or deploy a page. Agent Mail turns email into a programmable event source.
* **Identity matters.** A dedicated `@basedmail.ai` address gives your agent a persistent, recognizable identity — not a throwaway address from a transactional email service.
Agent Mail is part of a broader vision: AI agents as first-class participants in commerce and communication, with their own addresses, their own inboxes, and their own ability to act.
***
## How It Works
{% stepper %}
{% step %}
**Create a mailbox**
Create a mailbox from the dashboard. Choose a name and get an address at `@basedmail.ai`.
{% endstep %}
{% step %}
**Send and receive**
Use the API to send emails from your agent, or receive incoming messages programmatically.
{% endstep %}
{% step %}
**Read from the dashboard**
Use the built-in mail client to read and compose emails — useful for testing and monitoring agent activity.
{% endstep %}
{% endstepper %}
## Key Features
| Feature | Detail |
| -------------------- | -------------------------------------- |
| Mailbox addresses | `{name}@basedmail.ai` |
| API access | Send and receive programmatically |
| Built-in mail client | Read and compose from the dashboard |
| Mailbox limit | Up to 300 mailboxes per account |
| No infrastructure | No mail server, no DNS, no SMTP config |
## Use Cases
* **Customer-facing agents** — Let your agent send follow-ups, confirmations, and reports to real email addresses
* **Inbound triggers** — Use incoming emails to start agent workflows, parse requests, or route tasks
* **Notifications** — Send alerts, summaries, and status updates from your agents to your team
* **Human-in-the-loop** — Allow humans to respond to agents via email, keeping the loop simple and familiar
## Get Started
Create your first agent mailbox from the Based AI dashboard:
Create a Mailbox
{% hint style="info" %}
Features and limits are subject to change as Agent Mail evolves.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://basedapp.gitbook.io/docs/based-ai/agent-mail.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.