Your AI team, working in Agent Mail

AgentMail provides programmable email inboxes, messages, drafts, domains, webhooks, and related infrastructure for AI agents.

Start your company

What your team can do in Agent Mail

94 tools to work with, connected with an API key.

Batch Get MessagesReads only

Return metadata for up to 500 messages from one inbox in a single request. Compare count with limit to detect missing or restricted IDs. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.

Batch Update Message Labels

Atomically add or remove the same labels on up to 50 messages in one inbox. Missing or restricted message IDs are omitted from the result. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.

Complete File Upload

Mark a pending Agent Drive file ready after its bytes have been PUT to the presigned URL returned by CREATE_FILE. AgentMail verifies the exact declared size and SHA-256; calling this before a successful upload returns a conflict. Only a key with file_read or the key that created the file can complete it. Agent Drive is a US-production-only Labs feature.

Create Agent Armor Feedback

Record whether Agent Armor's completed verdict on a message was correct. A message accepts up to 20 feedback records.

Create Allowlist or Blocklist Entry

Add an email address or domain to an organization-wide send, receive, or reply allowlist or blocklist.

Create Calendar Event

Create a one-off or recurring event on a US-only inbox calendar. client_id makes retries safe; send_invites emails attendees and consumes send limits.

Create Draft

Create a draft, optionally scheduling its automatic delivery with send_at.

Create File

Initialize a pending Agent Drive file and return instructions for a direct storage upload. This does not upload bytes: PUT the exact bytes to the credential-sensitive presigned URL with every returned header unchanged and without the AgentMail API key, then call COMPLETE_FILE_UPLOAD. Identical requests are retry-safe. Pending files consume Drive quota immediately and expire after one day if incomplete; call DELETE_FILE when abandoning an upload. Agent Drive is a US-production-only Labs feature.

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. With Composio-managed credentials the address is on composio.agentmail.to (for example example@composio.agentmail.to) and inbox_id is that address plus a Composio signature (example@composio.agentmail.to.a1B2c3D4e5F6g). Give senders the returned email; use inbox_id only in AgentMail tool calls.

Create Inbox API Key

Create an inbox-scoped bearer key and return its one-time secret. Permissions can be specified to restrict the key.

Create Inbox in Pod

Create an inbox inside an explicitly selected AgentMail pod, optionally choosing its address, initial status, idempotency ID, and metadata.

Create Inbox Polling Webhook

Create or resume a polling webhook scoped to one inbox. The inbox comes from the path, so organization selector lists are not accepted. AgentMail's polling guide currently says polling is US-only even though the API reference lists an EU server; follow the guide and do not assume EU support. The response contains a one-time credential-sensitive polling token; store it securely and never log or expose it.

Create Inbox Webhook

Create a regular webhook scoped to one AgentMail inbox for a non-empty set of event types. The response contains a credential-sensitive signature secret; never log or expose it.

Create Pod

Create an AgentMail pod for grouping inboxes and related resources. With Composio-managed credentials each user has one pod: calling this again returns the same pod, and CREATE_INBOX and LIST_POD_INBOXES use it automatically when pod_id is omitted.

Create Polling Webhook

Create or resume an organization-level polling webhook for a non-empty set of event types, optionally filtered to at most 10 inboxes and pods combined. Current provider polling support is US-only (api.agentmail.to); do not use this action with an EU connection. The response contains a one-time, credential-sensitive polling token; store it securely and never log or expose it.

Create Webhook

Create an organization-level webhook for a non-empty set of event types, optionally filtered to at most 10 inboxes and pods combined. The response contains a credential-sensitive signature secret; never log or expose it.

Delete Allowlist or Blocklist Entry

Remove one email address or domain from an organization-wide send, receive, or reply allowlist or blocklist.

Delete Calendar Event

Accept asynchronous deletion of a US-only calendar event or cancel recurring dates. If-Match guards the version and Idempotency-Key makes retries deterministic.

Delete Draft

Permanently delete one unsent draft from an inbox.

Delete File

Permanently delete a pending or ready Agent Drive file and free its path. A previously issued presigned download URL can remain valid until its expiry. Requires file_delete, and only a key with file_read or the key that created the file can delete it. Agent Drive is a US-production-only Labs feature.

Delete Inbox

Permanently delete one inbox by ID. AgentMail accepts the deletion asynchronously, so acceptance does not guarantee immediate completion.

Delete Inbox Polling Webhook

Permanently delete an inbox-scoped polling webhook by webhook_id or client_id, invalidate its polling token, and free its subscription slot. AgentMail's polling guide currently says polling is US-only even though the API reference lists an EU server; follow the guide and do not assume EU support.

Delete Inbox Webhook

Permanently delete a regular webhook created for a selected AgentMail inbox and stop future deliveries.

Delete Message

Permanently delete one message from an inbox. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.

Delete Pod

Permanently delete one AgentMail pod by its unique ID.

Delete Pod Inbox

Permanently delete an inbox through its explicitly selected AgentMail pod, preserving the pod tenant boundary. A 202 response means deletion continues asynchronously; poll GET_POD_INBOX until it returns 404.

Delete Polling Webhook

Permanently delete an organization-level polling webhook by webhook_id or client_id, invalidate its polling token, and free its subscription slot. Current provider polling support is US-only (api.agentmail.to); do not use this action with an EU connection.

Delete Thread

Permanently delete one AgentMail thread and all of its messages.

Delete Webhook

Permanently delete an organization-level webhook and stop future deliveries.

Extend Inbox

Add whole months before an AgentMail inbox deactivates, or reactivate a deactivated inbox for that many months.

Forward Message

Immediately forward an existing message to new recipients with optional added content and attachments. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.

Get AgendaReads only

Get one page of non-cancelled calendar dates in a UTC window, expanding recurring events and ordering dates by start time. Calendar is available only in US production.

Get API KeyReads only

Retrieve API-key metadata without exposing bearer secret values.

Get CalendarReads only

Get an inbox's US-only calendar settings, event count, and ETag. Use primary consistency to read a just-completed write.

Get Calendar EventReads only

Get the full current form of a US-only calendar event or recurring-event date, including its opaque ETag for conditional mutations.

Get Current IdentityReads only

Return the connected AgentMail identity and its organization, pod, or inbox access boundary without exposing the credential itself.

Get DomainReads only

Return an AgentMail custom domain, its domain and tracking verification statuses, and all required DNS records.

Get Domain Setup LinkReads only

Build a one-click Domain Connect DNS setup link when supported. The returned signed URL must be delivered privately to the intended domain owner. Retain the sensitive state ephemerally and compare it on redirect; do not log either value.

Get Domain Zone FileReads only

Download the AgentMail-generated DNS zone file for a custom domain as a bounded binary file reference.

Get DraftReads only

Retrieve the complete contents and scheduling details of one draft.

Get Draft AttachmentReads only

Get a temporary download reference for one draft attachment.

Get FileReads only

Get Agent Drive file metadata. A ready file can include a credential-sensitive presigned download URL valid for up to one hour; treat it as a secret and never log or expose it. Requires file_read. Agent Drive is a US-production-only Labs feature.

Get InboxReads only

Retrieve one AgentMail inbox and its metadata by ID or email address.

Get Inbox Polling WebhookReads only

Get one inbox-scoped polling webhook by webhook_id or client_id. AgentMail's polling guide currently says polling is US-only even though the API reference lists an EU server; follow the guide and do not assume EU support. The polling token is never returned; create again with the same client_id to issue a new token.

Get Inbox WebhookReads only

Get one regular webhook created for a selected AgentMail inbox. The response contains a credential-sensitive signature secret; never log or expose it.

Get Inbox Webhook HeadersReads only

List only the names of custom delivery headers on an inbox-scoped regular webhook. Header values are credential-sensitive, write-only, and never returned.

Get MessageReads only

Retrieve an email message from an AgentMail inbox, including sender, recipients, labels, and available subject, body and attachment metadata. Use it to read individual messages discovered through message listing or webhooks.

Get Message AttachmentReads only

Get a temporary download reference for one message attachment. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.

Get OrganizationReads only

Return the connected AgentMail organization's identifiers, current inbox and domain counts, configured resource limits, and timestamps.

Get PodReads only

Retrieve one AgentMail pod by its unique ID.

Get Pod InboxReads only

Get an AgentMail inbox through an explicitly selected pod, preserving the pod tenant boundary.

Get Polling WebhookReads only

Get one organization-level polling webhook by webhook_id or client_id. Current provider polling support is US-only (api.agentmail.to); do not use this action with an EU connection. The polling token is never returned; create again with the same client_id to issue a new token.

Get Raw MessageReads only

Get a temporary download reference for one message's raw RFC 5322 source, including its original headers and MIME structure. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.

Get ThreadReads only

Retrieve one AgentMail thread and a paginated page of its messages.

Get Thread AttachmentReads only

Get a temporary download reference for an attachment using its thread and attachment IDs. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.

Get WebhookReads only

Get one organization-level webhook configuration by ID. The response contains a credential-sensitive signature secret; never log or expose it.

Get Webhook HeadersReads only

List only the names of custom delivery headers on an organization-level webhook. Header values are credential-sensitive, write-only, and never returned.

List Allowlist or Blocklist EntriesReads only

List one page of organization-wide send, receive, or reply allowlist or blocklist entries. Supply entry to retrieve one exact email address or domain.

List Calendar Event InstancesReads only

List one page of non-cancelled dates computed for a recurring US-only calendar event in a UTC window, including dates beyond the agenda horizon.

List Calendar EventsReads only

List one US-only calendar page of stored one-off events, recurring series, and edited series dates, including cancelled events, by most recent update.

List DomainsReads only

List one page of AgentMail custom domains and return the continuation token for the next page.

List DraftsReads only

List unsent drafts in an AgentMail inbox with filters and pagination.

List FilesReads only

List one page of an inbox's Agent Drive files in path order, including pending files. List items intentionally contain no presigned download URL; call GET_FILE for one. Requires file_read. Agent Drive is a US-production-only Labs feature.

List Inbox API KeysReads only

List API-key metadata scoped to an inbox without exposing secret values.

List Inbox EventsReads only

List label-change events from an AgentMail inbox.

List Inbox Polling WebhooksReads only

List polling webhooks created through one inbox route. Returns one page and an endpoint- and inbox-bound opaque continuation token. AgentMail's polling guide currently says polling is US-only even though the API reference lists an EU server; follow the guide and do not assume EU support. Polling tokens are never returned.

List Inbox WebhooksReads only

List one page of regular webhooks created for a selected AgentMail inbox. Responses contain credential-sensitive signature secrets; never log or expose them.

List InboxesReads only

List a page of inboxes available to the authenticated AgentMail account. Use this to discover inbox_id values for message operations; follow the next page token to retrieve more results.

List MessagesReads only

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

List Pod InboxesReads only

List one page of inboxes inside an AgentMail pod, or supply query to search addresses and display names. Follow next_page_token until absent, including after an empty search page. With Composio-managed credentials, omit pod_id to list your own pod. That call first gets your pod the same way AGENT_MAIL_CREATE_POD does, so it creates your one pod if you don't have it yet (free, never a second pod). Each returned inbox carries its signed inbox_id and pod_id, which work in the other AgentMail tools.

List PodsReads only

Return one page of AgentMail pods and its continuation token.

List Polling WebhooksReads only

List organization-level polling webhooks created through the organization route. Returns one page and an endpoint-bound opaque continuation token. Current provider polling support is US-only (api.agentmail.to); do not use this action with an EU connection. Polling tokens are never returned.

List ThreadsReads only

List conversation threads in an AgentMail inbox with filters.

List WebhooksReads only

List AgentMail webhook configurations.

Query Inbox Event MetricsReads only

Query timestamped email-event counts for an AgentMail inbox.

Query MetricsReads only

Query organization-wide email event counts or cumulative resource-usage time series over a bounded time range.

Query Rate MetricsReads only

Query organization-wide rolling bounce and complaint rates.

Release Held Message

Release a message that Agent Armor held for review, emit its delivery and security override events, and remove the agent-armor-held label. Only a still-held message with a review verdict can be released.

Reply To Message

Reply to a selected message while preserving its AgentMail thread.

Respond to Calendar Event

Accept, decline, or tentatively accept an email invitation on a US-only inbox calendar. By default AgentMail emails the organizer; If-Match guards the response.

Send Draft

Immediately send and consume a draft, optionally changing message labels.

Send Email

Send an email using AgentMail API

Send Message

Immediately send a new email from an AgentMail inbox with optional HTML, attachments, custom headers, labels, and open tracking. Use a draft instead when the message must be scheduled for later.

Update Calendar

Change an inbox calendar's default time zone in US production. Existing events retain their own time zones; optionally guard the update with If-Match.

Update Calendar Event

Patch a US-only calendar event, one recurring date, or that date and future dates. Explicit null clears only documented nullable fields; If-Match prevents overwrites.

Update Draft

Edit a draft, reschedule delivery with send_at, or cancel a scheduled send with cancel_scheduled_send=true.

Update Inbox

Update an inbox's display name, status, or custom metadata.

Update Inbox Webhook

Update an inbox-scoped regular webhook's enabled state or replace its event types. An empty update is allowed. The response contains a credential-sensitive signature secret; never log or expose it.

Update Inbox Webhook Headers

Atomically set, replace, or remove custom delivery headers on an inbox-scoped regular webhook. At least one real header change is required. Header values are credential-sensitive and write-only; never log or expose them.

Update Message Labels

Add or remove labels from one message in an inbox. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.

Update Pod Inbox

Update the display name, active or paused status, or metadata of an inbox inside an explicitly selected AgentMail pod. Provide at least one field.

Update Thread Labels

Add or remove custom labels from every message in one thread. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.

Update Webhook

Update an organization-level webhook's enabled state, event types, or inbox and pod subscriptions. An empty update is allowed. The response contains a credential-sensitive signature secret; never log or expose it.

Update Webhook Headers

Atomically set, replace, or remove custom delivery headers on an organization-level webhook. At least one real header change is required. Header values are credential-sensitive and write-only; never log or expose them.

More in Email

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or