Agent Mail

ai agents 5 tools available

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 Visit Agent Mail

About this integration

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.

Connect Agent Mail to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.

Auth OAuth2 · 2 clicks

Tools 5 exposed

Plans All, incl. Free

Data Never trained on

Agent Mail · in workflows

What teams actually run.

Three patterns teams run with Agent Mail on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.

Trigger on event

│ Listen for a new event

│ Parse and validate the payload

└ Take an action with the linked tool

Daily summary

│ Pull yesterday's activity

│ Summarise with the model of your choice

└ Send the digest via email or Slack

Cross-tool sync

│ Read records from one app

│ Transform with a persona

└ Write the result back via this integration

5 tools available

The Agent Mail toolbox.

Every Agent Mail capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.

Create Inbox

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.

Get Message

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 Inboxes

List all inboxes available to the authenticated AgentMail account. Use this to discover valid inbox_id values for message operations.

List Messages

List messages from an AgentMail inbox. Returns a `messages` array; each message uses `message_id` and `timestamp` fields (not `id`, `date`, or `items`).

Send Email

Send an email using AgentMail API

See it run

One prompt, start to finish.

A real prompt, the Agent Mail tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.

❯

Run a real Agent Mail task end-to-end — plan it, execute across the API, and hand back a verified result.

agent_mail.create_inbox Create a new AgentMail inbox via API. Returns the inbox_id and email address for sending/r

agent_mail.get_message Retrieve the complete details of a specific email message from an AgentMail inbox. This ac

agent_mail.list_inboxes List all inboxes available to the authenticated AgentMail account. Use this to discover va · verified

done

Done. Agent Mail responded across 3 calls, the verifier signed off, and the result is logged with every payload.

FAQ · Agent Mail

Questions, answered.

What teams ask before connecting Agent Mail.

01 What can I automate with Agent Mail on Definable?

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.

02 How does Agent Mail authentication work?

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.

03 Is the Agent Mail integration included in my Definable plan?

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.

04 Is using Agent Mail through Definable secure?

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.

05 How do I get started with Agent Mail on Definable?

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.

06 What Agent Mail actions does Definable expose?

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.