> ## Documentation Index > Fetch the complete documentation index at: https://docs.waterr.ai/llms.txt > Use this file to discover all available pages before exploring further. # Agent Mail > Give an agent its own email address. Invite it to a calendar event and it joins the meeting on its own. **Agent Mail** gives each of your agents a real email address, such as `ava.waterr@agent.waterr.ai`, backed by its own Google identity. The most common use is meetings. You add the agent's address as a guest on a calendar invite, the same way you'd invite a colleague. At the start time the agent joins the Google Meet, Zoom or Teams call on its own. You don't need to send it a link or start anything in the Studio. Every invitation, reply and email sent to the address is kept in the agent's inbox, and you can read the latest messages from the agent's Settings. > [!NOTE] > > Agent Mail is a **beta** feature, available on the **Growth plan and above**. A workspace admin has to turn it on before anyone in the workspace can use it. ## How it works **1. The agent gets an address** You create an inbox from the agent's Settings. Waterr sets up the email address, a Google identity with the same address and the mailbox that stores its mail. **2. You invite it to a meeting** Add the address as a guest on a calendar event that has a Google Meet, Zoom or Teams link, from Google Calendar, Outlook or any other calendar. **3. Waterr checks who sent the invitation** The agent only acts on invitations from **trusted** organizers. When you create the inbox, your own email is trusted. The invitation must also pass email authentication checks, so a forged invite from someone pretending to be you is ignored. **4. The agent joins at the start time** About a minute before the meeting starts, the agent joins the call as a participant, under the name you chose, and runs the meeting the way you set it up. ## Turn on Agent Mail Agent Mail is turned on for the whole workspace. Only workspace **owners and admins** can change it. **1. Open Settings › Labs** In the Studio, go to **Settings**, then the **Labs** tab. **2. Switch on Agent inboxes** Under **Beta features**, turn on **Agent inboxes**. This adds **Platform › Agent inboxes** and an **Agent inbox** section to every agent's Settings. If you aren't an admin, the Labs page shows *"Only workspace admins can change these."* Ask an admin to turn the feature on for you. If your workspace is on a plan below Growth, the Agent inbox section shows **Upgrade your plan** in place of the form. ## Give an agent an email address Each agent can have one inbox. **1. Open the agent's Settings** Open the agent in the Studio, go to its **Settings** tab and choose **Agent inbox**. **2. Pick the address** The **Address** field is filled in from the persona's name as `firstname.lastname`. "Ava Waterr" becomes `ava.waterr@agent.waterr.ai`. You can change it. The field checks availability as you type and shows **Available**, **Taken. Try another name.** or **Already one of your agent inboxes.** **3. Set the name shown in meetings** **Name shown in meetings** is the display name other participants see when the agent joins, for example "Ava from Acme". **4. Create the inbox** Click **Create inbox**. The form shows which email will be trusted ("Invitations from [you@company.com](mailto:you@company.com) will be trusted"). When it's done, you'll see *"[ava.waterr@agent.waterr.ai](mailto:ava.waterr@agent.waterr.ai) is ready"*. ### Address rules | Rule | Detail | | - | - | | Domain | Every address ends in `@agent.waterr.ai` | | Length | 1 to 50 characters | | Characters | Lowercase letters, numbers, dots (`.`), dashes (`-`) and underscores (`_`) | | Start and end | Must start and end with a letter or a number | | Reserved names | Names like `admin`, `support`, `postmaster` and `noreply` aren't allowed | | Taken names | If the suggestion is taken, a number is added: `ava.waterr2`, `ava.waterr3` and so on | The address can't be renamed after you create it, so choose it carefully. ## Invite the agent to a meeting Once the inbox exists, the Agent inbox card shows the address with a **Copy** button and a **Meetings** setting. **1. Turn on auto-join** Under **Meetings**, switch on **Join meetings it is invited to**. When this is on, the agent joins about a minute before the start time of Google Meet, Zoom and Teams invitations. **2. Add the agent to your calendar event** Create or edit an event in your calendar, add the agent's address as a guest and make sure the event has a meeting link. **3. Send the invitation** Save the event so the invitation is emailed. The agent receives it like any guest would. > [!TIP] > > Invite the agent **as a guest on the event**. If you only paste the meeting link into an email, the agent has no invitation to act on. It then asks to join the call, and someone in the meeting has to let it in. ### Which invitations the agent accepts The agent joins a meeting only when **both** of these are true: * The invitation comes from a **trusted organizer**. By default that is the person who created the inbox. * The email **passes authentication**: the sender's domain signs it and the checks match. This stops someone from faking an invite in your name. Anyone can email the address, and those messages are stored and appear in the inbox, but they never make the agent join a call. ### The agent's Google identity Each inbox comes with a Google identity at the same address, which helps the agent get into Google Meet calls the way a signed-in guest would. The card shows its state: | Label | Meaning | | - | - | | **Google identity · signed in** | The identity is set up and has signed in | | **Google identity · signs in on first meeting** | The identity exists and signs in the first time the agent joins a meeting | | **No Google identity** | No identity is attached to this inbox | ## Read the agent's mail The **Recent mail** list on the agent's Agent inbox card shows the latest 20 messages, newest first. It refreshes every 30 seconds. Each row shows: * An arrow for **received** or **sent** * The sender, or **To …** for mail the inbox sent * When it arrived * The subject and a one-line preview Unread messages are shown in bold. Before any mail arrives the list shows *"Nothing yet. Invitations and replies sent to … show up here."* > [!NOTE] > > The Recent mail list is read-only. You can't open a full message, see attachments, reply or compose from the Studio yet. ## Manage all your inboxes **Platform › Agent inboxes** lists every inbox in your workspace: | Column | What it shows | | - | - | | **Address** | The agent's email address | | **Assigned to** | The agent that uses this address. Pick another agent from the dropdown to move the address to it. | | **Google identity** | **Signed in**, **Ready** or **Missing** | | **Joins meetings** | **On** or **Off**, from the agent's auto-join setting | Moving an address keeps its mail history. Future invitations to that address are handled by the new agent. If you don't have any inboxes yet, the page links to your agents so you can create one. ## What the agent can and can't do with email Today Agent Mail is how the agent **receives meeting invitations**. Keep these limits in mind: * **The agent doesn't read or answer email during calls or in chat.** Mail is stored and shown to you, but the agent's conversations don't use it. * **You can't send mail from the Studio.** Sending, replying and drafts are only available through the developer API (below). * **Only the inbox creator is trusted by default.** You can't yet add teammates as trusted organizers from the Studio. * **Inboxes can't be deleted or paused from the Studio.** You can move an address to a different agent from Platform › Agent inboxes. ## For developers: the Agent Mailbox API Agent Mail runs on **Agent Mailbox**, Waterr's email service for AI agents. If you're building your own agent, you can use it directly to create inboxes, read threads, send and reply, keep drafts for approval, and get an event the moment mail arrives. You can also connect it to Claude Code, ChatGPT or any MCP client with your Waterr API key. > [card] [Agent Mailbox overview](https://docs.waterr.ai/agent-mailbox/introduction) > > What the service does and how threads, events and inboxes fit together. > [card] [Quickstart](https://docs.waterr.ai/agent-mailbox/quickstart) > > Create an inbox and send your first message from code. > [card] [MCP server](https://docs.waterr.ai/agent-mailbox/mcp) > > Give Claude, Cursor or any MCP client its own inbox. > [card] [Custom domains](https://docs.waterr.ai/agent-mailbox/domains) > > Receive mail at an address on your own domain. > [!NOTE] > > Inboxes you create through the API are separate from the ones you create in the Studio and don't appear in the Studio's lists. While Agent Mailbox is in beta, sending from the API to addresses outside `agent.waterr.ai` is limited. ## Troubleshooting > [accordion] I don't see Agent inbox in my agent's Settings > > A workspace admin needs to turn on **Agent inboxes** in **Settings › Labs**. If the section appears but is blurred, your plan is below Growth. Upgrade to use Agent Mail. > [accordion] The agent didn't join my meeting > > Check these in order: > > 1. **Join meetings it is invited to** is switched on in the agent's Agent inbox card. > 2. The agent's address was added as a **guest on the event**, not only pasted as a link. > 3. The event has a Google Meet, Zoom or Teams link. > 4. The invitation came from the person who created the inbox. Invitations from other organizers aren't trusted yet. > 5. The invitation shows up in **Recent mail**. If it isn't there, the calendar didn't send an email to the guest. > [accordion] The agent asked to join instead of joining directly > > The agent received the meeting link but no calendar invitation. Add its address as a guest on the event, or let it in from the meeting's waiting room. > [accordion] The address I want is taken > > Addresses are unique across all of `agent.waterr.ai`. Try a variation, such as adding your company name: `ava.acme`. ## Related * [Agent Computer](https://docs.waterr.ai/agent-tools/agent-computer.md): give the agent a machine where it does real work for you * [Google Meet](https://docs.waterr.ai/integrations/google-meet.md), [Zoom](https://docs.waterr.ai/integrations/zoom.md) and [Microsoft Teams](https://docs.waterr.ai/integrations/microsoft-teams.md): how the agent behaves inside each platform * [Send an Agent to a Meeting](https://docs.waterr.ai/getting-started/send-agent.md): other ways to get the agent into a call This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.