• Customers
  • Docs
  • Pricing
Log inLGet startedS
Email

Platform

Start here

  • Get started
  • Use the API
  • CLI reference

Concepts

  • Sandboxes
  • Commands
  • Model providers
  • Files
  • Images and registries
  • Volumes
  • Secrets
  • Endpoints
  • Connections

Reference

  • SSO and SCIM
  • Organizations and access
  • API reference

Company agent

Start here

  • Get started
  • Core concepts

Set up

  • Models
  • Sandboxes
  • Knowledge
  • Integrations
  • Secrets
  • Instructions and skills
  • Members and roles

Use Adapt

  • Agents
  • Chats and tool activity
  • Automations

Surfaces

  • Slack
  • GitHub
  • Email
  • iMessage and SMS
  • Webhooks

Run Adapt

  • Self-host
  • Security and privacy

Platform

Start here

  • Get started
  • Use the API
  • CLI reference

Concepts

  • Sandboxes
  • Commands
  • Model providers
  • Files
  • Images and registries
  • Volumes
  • Secrets
  • Endpoints
  • Connections

Reference

  • SSO and SCIM
  • Organizations and access
  • API reference

Company agent

Start here

  • Get started
  • Core concepts

Set up

  • Models
  • Sandboxes
  • Knowledge
  • Integrations
  • Secrets
  • Instructions and skills
  • Members and roles

Use Adapt

  • Agents
  • Chats and tool activity
  • Automations

Surfaces

  • Slack
  • GitHub
  • Email
  • iMessage and SMS
  • Webhooks

Run Adapt

  • Self-host
  • Security and privacy

The open platform for company agents. Use the whole platform or build with individual components.

Products

Company agentAI Transformation ServicesSandboxesStorageModel gatewayPricing

Solutions

EnterpriseFor CEOsEngineeringOperationsSalesAll solutions

Resources

DocumentationDeveloper guideChangelogBlogCustomer storiesIntegrations

Company

AboutCareersTrust centerSupportTalk to usGet started

Social

XLinkedInGitHubYouTube
© 2026 AdaptMade with ♥ in Adapt teammates walking outside the Presidio officeAn Adapt engineer at their desk at dusk, the Golden Gate through the windowAn Adapt teammate pointing to the Adapt sign at the office doorTermsPrivacy

Surfaces

Email

On this page
  1. Add email to an agent
  2. Check the connection
  3. Who the agent answers
  4. What the agent reads
  5. Replies
  6. Read email threads in Adapt

The email surface gives an agent an inbox: people email it, and the agent replies in the same email thread. Adapt sends and receives mail through AgentMail.

Each email thread is one conversation with the agent. An email becomes an ordinary run with the agent's model, tools, and limits, and the final answer goes back as a reply from the inbox. AgentMail gives a forwarded email a thread of its own, so forwarding mail to the agent starts a new conversation.

Add email to an agent

You need an AgentMail account. Only owners and admins can add a surface. Go to Agents, open the agent, then Settings → Where it answers → Add surface → AgentMail, and choose Set up with the agent.

Let Adapt create the inbox

Paste one AgentMail API key and choose Create inbox. Adapt uses the key to create the inbox, register a webhook for it, and mint a new key limited to that inbox. The key you paste is used for that one request and never saved.

Create the key in AgentMail under API Keys with:

  • Scope: Entire organization.
  • Access: Advanced / Custom, with only inbox_create, webhook_create, api_key_create, inbox_read, message_read, message_send, and webhook_read on.
  • Expiration: Never.

The inbox key Adapt keeps inherits the expiry of the key that made it. If the pasted key expires, the setup check shows the date, and mail stops then; connect the inbox again with a key that never expires.

Adapt saves the inbox address and webhook in the connection, and the inbox key and the webhook's signing secret as encrypted credentials. The saved key can read the inbox, read and send messages, and read webhooks. It can't create webhooks or keys, or delete anything.

Connect an inbox you already have

Choose Use an existing inbox and enter:

  • Inbox address: the full address people email, such as agent@agentmail.to.
  • API key: scope Single inbox, access Advanced / Custom with only inbox_read, message_read, message_send, and webhook_read on.
  • Webhook signing secret: in AgentMail, open Webhooks and create one for this inbox at the connection's Webhook URL, <your Adapt URL>/api/surfaces/<connection ID>, subscribed to message.received only. Copy its signing secret (it starts with whsec_).

The Webhook URL must be a public HTTPS address; see Self-host.

Check the connection

Open the agent's AgentMail row under Where it answers to see its Setup check:

  • Inbox: the key can read the inbox.
  • Webhook: Adapt reads the webhook back and fails the check if it's off, points somewhere else, subscribes to more than message.received, or holds a different signing secret than the one saved. AgentMail turns a webhook off on its own after 5 days of failed deliveries.
  • Email: passes once mail has started a run. To confirm, email the inbox from your Adapt sign-in address.

If mail reaches Adapt but nothing runs, the sender usually isn't a member, or the mail failed one of the checks below. A connection that's on is permitted to run, not verified healthy.

Who the agent answers

By default, only mail from a workspace member's Adapt sign-in address starts a run. The run acts as that member, with their role and access.

Each email surface comes with an automation, Respond to email, on the agent's Automations tab. Turning on Allow responses to non-workspace members for its event lets anyone else who emails the inbox get an answer too. Those runs are anonymous: no Adapt user, no workspace role, and no email tools.

Adapt skips, without a run:

  • mail whose sender AgentMail couldn't authenticate: the message must pass DMARC, so mail from a domain without SPF, DKIM, and a DMARC policy is skipped;
  • auto-replies, bounces, and mailing-list mail;
  • the inbox's own mail, and anything AgentMail marks as spam, blocked, or unauthenticated.

What the agent reads

The sender's own words are the request. When someone forwards mail, or replies on a thread this inbox never saw, the quoted part follows under a marker that labels it untrusted: material to work with, never instructions. A reply with no words of its own sends the quoted text as the request, and the agent asks what to do with it.

Two tools let the agent find other mail for the member who asked:

  • email_search: full-text search across threads in this inbox that the member is on, by sender, recipients, subject, and body.
  • email_read_thread: reads every message in one of those threads, oldest first.

Being on any message in a thread opens the whole thread. These tools are also available in the agent's other conversations, such as web chats, for the signed-in member. Results are marked untrusted. Anonymous runs don't get them, and history search and Adapt administration tools are never available in email threads.

Replies

Each answer is a plain-text reply to the email that started the run. It goes to the sender Adapt admitted, and copies only the workspace members who were on that email. The reply address is fixed when the email arrives, so a later change to From or Reply-To can't redirect the answer. A failed or interrupted run sends a short error instead.

  • Files in: attachments on incoming email aren't passed to the agent; only the text is.
  • Files out: up to 10 files and 4 MiB, sent on the same reply. If the files would push the email past AgentMail's size limit, or AgentMail refuses them, the text goes alone and names the files it left out.

AgentMail may refuse to send, for example when the inbox is paused. That delivery is marked failed with AgentMail's reason. If AgentMail times out or answers unclearly after the send started, the delivery is marked uncertain and never resent, since the email may already have gone out.

Read email threads in Adapt

The member who started an email thread sees it in their chat sidebar. Any member who can view the agent can open an email conversation in Adapt, read-only, with each message labeled by its author or as anonymous. To continue it, reply by email. The thread's owner and admins can rename or delete it; the next email on that thread then starts a fresh conversation.

PreviousGitHubNextiMessage and SMS

On this page

  1. Add email to an agent
  2. Check the connection
  3. Who the agent answers
  4. What the agent reads
  5. Replies
  6. Read email threads in Adapt