Agent Mail for AI agents
Agents read Agent Mail at once. Changes and sends are held for a person's approval by default.
About Agent Mail
AgentMail provides AI agents with their own email inboxes, enabling them to send, receive, and act upon emails for communication with services, people, and other agents.
What an agent can do in Agent Mail
Every Agent Mail action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Agent Mail without asking first. 11 actions.
- List InboxesList all inboxes available to the authenticated AgentMail account. Use this to discover valid inbox_id values for message operations.
- Get DraftRetrieve the complete contents and scheduling details of one draft.
- Get MessageRetrieve the complete details of a specific email message from an AgentMail inbox. This action returns the full message content including sender, recipients, subject, body (both text and HTML), attach
- Get ThreadRetrieve one AgentMail thread and a paginated page of its messages.
- List DraftsList unsent drafts in an AgentMail inbox with filters and pagination.
- List Inbox API KeysList API-key metadata scoped to an inbox without exposing secret values.
- List Inbox EventsList label-change events from an AgentMail inbox.
- List MessagesList messages from an AgentMail inbox. Returns a `messages` array; each message uses `message_id` and `timestamp` fields (not `id`, `date`, or `items`).
- List ThreadsList conversation threads in an AgentMail inbox with filters.
- Query Inbox Event MetricsQuery timestamped email-event counts for an AgentMail inbox.
- Query Rate MetricsQuery organization-wide rolling bounce and complaint rates.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 8 actions.
- Create InboxCreate a new AgentMail inbox via API. Returns the inbox_id and email address for sending/receiving messages. Use when provisioning new inboxes for agents or workflows.
- Create Inbox API KeyCreate an inbox-scoped bearer key and return its one-time secret. Omitting permissions grants all permissions available within the inbox scope.
- Create DraftCreate a draft, optionally scheduling its automatic delivery with send_at.
- Delete ThreadPermanently delete one AgentMail thread and all of its messages.
- Reply To MessageReply to a selected message while preserving its AgentMail thread.
- Send DraftImmediately send and consume a draft, optionally changing message labels.
- Send EmailSend an email using AgentMail API
- Update DraftEdit a draft, reschedule delivery, or cancel a scheduled send with null.
Changes wait in Needs you
Changes and sends in Agent Mail are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Agent Mail questions
Can an agent change data in Agent Mail on its own?
Not by default. Changes and sends in Agent Mail are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Agent Mail?
This connector lists 11 read actions. Reads run at once, without waiting for approval.
How does Agent Mail connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.