Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
5 tools available · 1 trigger
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.
Connect Agent Mail to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Agent Mail's 5 tools (and react to 1 trigger) directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Every Agent Mail action below is a callable tool any Definable persona can invoke.
Create 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.
Retrieve 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), attachments, labels, and metadata. Use this to read individual messages after discovering them via LIST_MESSAGES or webhooks.
List all inboxes available to the authenticated AgentMail account. Use this to discover valid inbox_id values for message operations.
List messages from an AgentMail inbox. Returns a `messages` array; each message uses `message_id` and `timestamp` fields (not `id`, `date`, or `items`).
Send an email using AgentMail API
Anything Agent Mail exposes through its API. Common ai agents workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 5 Agent Mail tools directly, or react to its 1 trigger, then chain the result into another integration without you writing code.
Agent Mail uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Yes — every Definable plan, including Starter, includes access to all 5 Agent Mail tools. You only need a separate Agent Mail subscription if Agent Mail itself charges per seat or per API call.
Every call from a persona to Agent Mail is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
Sign up for Definable, open the integrations page, find Agent Mail, and connect via OAuth or API key. You can immediately attach Agent Mail to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
Definable exposes all 5 Agent Mail actions as callable tools — including `Create Inbox`, `Get Message`, `List Inboxes`, plus 2 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Wire it up in minutes. No coding required.