How to connect Agent mail to Claude

Return metadata for up to 500 messages from one inbox in a single request.

Atomically add or remove the same labels on up to 50 messages in one inbox.

Mark a pending Agent Drive file ready after its bytes have been PUT to the presigned URL returned by CREATE_FILE.

Record whether Agent Armor's completed verdict on a message was correct.

Create a one-off or recurring event on a US-only inbox calendar.

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

Initialize a pending Agent Drive file and return instructions for a direct storage upload.

Create a new AgentMail inbox via API.

Create an inbox-scoped bearer key and return its one-time secret.

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

Create or resume a polling webhook scoped to one inbox.

Create a regular webhook scoped to one AgentMail inbox for a non-empty set of event types.

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.

Create an organization-level webhook for a non-empty set of event types, optionally filtered to at most 10 inboxes and pods combined.

Accept asynchronous deletion of a US-only calendar event or cancel recurring dates.

Permanently delete one unsent draft from an inbox.

Permanently delete a pending or ready Agent Drive file and free its path.

Permanently delete one inbox by ID.

Permanently delete an inbox-scoped polling webhook by webhook_id or client_id, invalidate its polling token, and free its subscription slot.

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.

Permanently delete one AgentMail pod by its unique ID.

Permanently delete an inbox through its explicitly selected AgentMail pod, preserving the pod tenant boundary.

Permanently delete an organization-level polling webhook by webhook_id or client_id, invalidate its polling token, and free its subscription slot.

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.

Get one page of non-cancelled calendar dates in a UTC window, expanding recurring events and ordering dates by start time.

Retrieve API-key metadata without exposing bearer secret values.

Get an inbox's US-only calendar settings, event count, and ETag.

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.

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.

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

Get one inbox-scoped polling webhook by webhook_id or client_id.

Get one regular webhook created for a selected AgentMail inbox.

List only the names of custom delivery headers on an inbox-scoped regular webhook.

Retrieve the complete details of a specific email message from an AgentMail inbox.

Get a temporary download reference for one message attachment.

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.

Get a temporary download reference for one message's raw RFC 5322 source, including its original headers and MIME structure.

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.

Get one organization-level webhook configuration by ID.

List only the names of custom delivery headers on an organization-level webhook.

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

List all inboxes available to the authenticated AgentMail account.

List label-change events from an AgentMail inbox.

List polling webhooks created through one inbox route.

List one page of regular webhooks created for a selected AgentMail inbox.

List one page of organization-wide send, receive, or reply allowlist or blocklist entries.

List messages from an AgentMail inbox.

List one page of inboxes inside an explicitly selected AgentMail pod, or supply query to search addresses and display names.

Return one page of AgentMail pods and its continuation token.

List organization-level polling webhooks created through the organization route.

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.

Reply to a selected message while preserving its AgentMail thread.

Accept, decline, or tentatively accept an email invitation on a US-only inbox calendar.

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.

Change an inbox calendar's default time zone in US production.

Patch a US-only calendar event, one recurring date, or that date and future dates.

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.

Atomically set, replace, or remove custom delivery headers on an inbox-scoped regular webhook.

Add or remove labels from one message in an inbox.

Update the display name, active or paused status, or metadata of an inbox inside an explicitly selected AgentMail pod.

Add or remove custom labels from every message in one thread.

Update an organization-level webhook's enabled state, event types, or inbox and pod subscriptions.

Atomically set, replace, or remove custom delivery headers on an organization-level webhook.