Skip to main content
Agent Mail gives each of your agents a real email address, such as [email protected], 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.
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 [email protected]. 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 [email protected] will be trusted”). When it’s done, you’ll see “[email protected] is ready”.

Address rules

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.
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:

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.”
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: 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.

Agent Mailbox overview

What the service does and how threads, events and inboxes fit together.

Quickstart

Create an inbox and send your first message from code.

MCP server

Give Claude, Cursor or any MCP client its own inbox.

Custom domains

Receive mail at an address on your own domain.
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

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.
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.
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.
Addresses are unique across all of agent.waterr.ai. Try a variation, such as adding your company name: ava.acme.