Agent Mail

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.

Common workflows with Agent Mail

01

Trigger on event

  1. Listen for a new event
  2. Parse and validate the payload
  3. Take an action with the linked tool
02

Daily summary

  1. Pull yesterday's activity
  2. Summarise with the model of your choice
  3. Send the digest via email or Slack
03

Cross-tool sync

  1. Read records from one app
  2. Transform with a persona
  3. Write the result back via this integration

Agent Mail actions 5

Every Agent Mail action below is a callable tool any Definable persona can invoke.

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

Frequently asked questions

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.

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.

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.

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.

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.

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.

Ready to automate with Agent Mail?

Wire it up in minutes. No coding required.

← All integrations