Add Agent Mail to your AI agent

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.

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

Create an AgentMail pod for grouping inboxes and related resources.

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 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.

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

Permanently delete one unsent draft from an inbox.

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.

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

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.

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

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

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.

Permanently delete one AgentMail pod by its unique ID.

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.

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.

Permanently delete one AgentMail thread and all of its messages.

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

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 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.

Retrieve API-key metadata without exposing bearer secret values.

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

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

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

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

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.

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

Retrieve the complete contents and scheduling details of one draft.

Get a temporary download reference for one draft attachment.

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.

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

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 one regular webhook created for a selected AgentMail inbox. The response contains a credential-sensitive signature secret; never log or expose it.

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

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.

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.

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

Retrieve one AgentMail pod by its unique ID.

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

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 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.

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

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 one organization-level webhook configuration by ID. The response contains a credential-sensitive signature secret; never log or expose it.

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

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 one US-only calendar page of stored one-off events, recurring series, and edited series dates, including cancelled events, by most recent update.

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

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

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 API-key metadata scoped to an inbox without exposing secret values.

List label-change events from an AgentMail inbox.

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 one page of regular webhooks created for a selected AgentMail inbox. Responses contain credential-sensitive signature secrets; never log or expose them.

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 messages from an AgentMail inbox. Returns a `messages` array; each message uses `message_id` and `timestamp` fields (not `id`, `date`, or `items`).

List one page of inboxes inside an explicitly selected AgentMail pod, or supply query to search addresses and display names. Follow next_page_token until absent, including after an empty search page.

Return one page of AgentMail pods and its continuation token.

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 conversation threads in an AgentMail inbox with filters.

List AgentMail webhook configurations.

Query timestamped email-event counts for an AgentMail inbox.

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

Query organization-wide rolling bounce and complaint rates.

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 a selected message while preserving its AgentMail thread.

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.

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

Send an email using AgentMail API

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.

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.

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.

Edit a draft, reschedule delivery, or cancel a scheduled send with null.

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

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.

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.

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 the display name, active or paused status, or metadata of an inbox inside an explicitly selected AgentMail pod. Provide at least one field.

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 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.

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.