Agent Mail
AgentMail provides programmable email inboxes, messages, drafts, domains, webhooks, and related infrastructure for AI agents.
Uses your own API key. Composio asks for it once and keeps it; Quilt never sees it.
Reads on its own47
Agents use these right away.
- List InboxesList a page of inboxes available to the authenticated AgentMail account.
- Batch Get MessagesReturn metadata for up to 500 messages from one inbox in a single request.
- Get AgendaGet one page of non-cancelled calendar dates in a UTC window, expanding recurring events and ordering dates by start time.
- Get API KeyRetrieve API-key metadata without exposing bearer secret values.
- Get CalendarGet an inbox's US-only calendar settings, event count, and ETag.
- Get Calendar EventGet the full current form of a US-only calendar event or recurring-event date, including its opaque ETag for conditional mutations.
- Get Current IdentityReturn the connected AgentMail identity and its organization, pod, or inbox access boundary without exposing the credential itself.
- Get DomainReturn an AgentMail custom domain, its domain and tracking verification statuses, and all required DNS records.
- Get Domain Setup LinkBuild a one-click Domain Connect DNS setup link when supported.
- Get Domain Zone FileDownload the AgentMail-generated DNS zone file for a custom domain as a bounded binary file reference.
- Get DraftRetrieve the complete contents and scheduling details of one draft.
- Get Draft AttachmentGet a temporary download reference for one draft attachment.
- Get FileGet Agent Drive file metadata.
- Get InboxRetrieve one AgentMail inbox and its metadata by ID or email address.
- Get Inbox Polling WebhookGet one inbox-scoped polling webhook by webhook_id or client_id.
- Get Inbox WebhookGet one regular webhook created for a selected AgentMail inbox.
- Get Inbox Webhook HeadersList only the names of custom delivery headers on an inbox-scoped regular webhook.
- Get MessageRetrieve an email message from an AgentMail inbox, including sender, recipients, labels, and available subject, body and attachment metadata.
- Get Message AttachmentGet a temporary download reference for one message attachment.
- Get OrganizationReturn the connected AgentMail organization's identifiers, current inbox and domain counts, configured resource limits, and timestamps.
- Get PodRetrieve one AgentMail pod by its unique ID.
- Get Pod InboxGet an AgentMail inbox through an explicitly selected pod, preserving the pod tenant boundary.
- Get Polling WebhookGet one organization-level polling webhook by webhook_id or client_id.
- Get Raw MessageGet a temporary download reference for one message's raw RFC 5322 source, including its original headers and MIME structure.
- Get ThreadRetrieve one AgentMail thread and a paginated page of its messages.
- Get Thread AttachmentGet a temporary download reference for an attachment using its thread and attachment IDs.
- Get WebhookGet one organization-level webhook configuration by ID.
- Get Webhook HeadersList only the names of custom delivery headers on an organization-level webhook.
- List Calendar Event InstancesList 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 EventsList one US-only calendar page of stored one-off events, recurring series, and edited series dates, including cancelled events, by most recent update.
- List DomainsList one page of AgentMail custom domains and return the continuation token for the next page.
- List DraftsList unsent drafts in an AgentMail inbox with filters and pagination.
- List FilesList one page of an inbox's Agent Drive files in path order, including pending files.
- List Inbox API KeysList API-key metadata scoped to an inbox without exposing secret values.
- List Inbox EventsList label-change events from an AgentMail inbox.
- List Inbox Polling WebhooksList polling webhooks created through one inbox route.
- List Inbox WebhooksList one page of regular webhooks created for a selected AgentMail inbox.
- List Allowlist or Blocklist EntriesList one page of organization-wide send, receive, or reply allowlist or blocklist entries.
- List MessagesList messages from an AgentMail inbox.
- List Pod InboxesList one page of inboxes inside an explicitly selected AgentMail pod, or supply query to search addresses and display names.
- List PodsReturn one page of AgentMail pods and its continuation token.
- List Polling WebhooksList organization-level polling webhooks created through the organization route.
- List ThreadsList conversation threads in an AgentMail inbox with filters.
- List WebhooksList AgentMail webhook configurations.
- Query Inbox Event MetricsQuery timestamped email-event counts for an AgentMail inbox.
- Query MetricsQuery organization-wide email event counts or cumulative resource-usage time series over a bounded time range.
- Query Rate MetricsQuery organization-wide rolling bounce and complaint rates.
Asks someone first46
Anything that sends, creates, changes or deletes waits for a person to approve it in the session’s chat.
- Create InboxCreate a new AgentMail inbox via API.
- Create Inbox API KeyCreate an inbox-scoped bearer key and return its one-time secret.
- Batch Update Message LabelsAtomically add or remove the same labels on up to 50 messages in one inbox.
- Complete File UploadMark a pending Agent Drive file ready after its bytes have been PUT to the presigned URL returned by CREATE_FILE.
- Create Agent Armor FeedbackRecord whether Agent Armor's completed verdict on a message was correct.
- Create Calendar EventCreate a one-off or recurring event on a US-only inbox calendar.
- Create DraftCreate a draft, optionally scheduling its automatic delivery with send_at.
- Create FileInitialize a pending Agent Drive file and return instructions for a direct storage upload.
- Create Inbox in PodCreate an inbox inside an explicitly selected AgentMail pod, optionally choosing its address, initial status, idempotency ID, and metadata.
- Create Inbox Polling WebhookCreate or resume a polling webhook scoped to one inbox.
- Create Inbox WebhookCreate a regular webhook scoped to one AgentMail inbox for a non-empty set of event types.
- Create Allowlist or Blocklist EntryAdd an email address or domain to an organization-wide send, receive, or reply allowlist or blocklist.
- Create PodCreate an AgentMail pod for grouping inboxes and related resources.
- Create Polling WebhookCreate 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 WebhookCreate an organization-level webhook for a non-empty set of event types, optionally filtered to at most 10 inboxes and pods combined.
- Delete Calendar EventAccept asynchronous deletion of a US-only calendar event or cancel recurring dates.
- Delete DraftPermanently delete one unsent draft from an inbox.
- Delete FilePermanently delete a pending or ready Agent Drive file and free its path.
- Delete InboxPermanently delete one inbox by ID.
- Delete Inbox Polling WebhookPermanently delete an inbox-scoped polling webhook by webhook_id or client_id, invalidate its polling token, and free its subscription slot.
- Delete Inbox WebhookPermanently delete a regular webhook created for a selected AgentMail inbox and stop future deliveries.
- Delete Allowlist or Blocklist EntryRemove one email address or domain from an organization-wide send, receive, or reply allowlist or blocklist.
- Delete MessagePermanently delete one message from an inbox.
- Delete PodPermanently delete one AgentMail pod by its unique ID.
- Delete Pod InboxPermanently delete an inbox through its explicitly selected AgentMail pod, preserving the pod tenant boundary.
- Delete Polling WebhookPermanently delete an organization-level polling webhook by webhook_id or client_id, invalidate its polling token, and free its subscription slot.
- Delete ThreadPermanently delete one AgentMail thread and all of its messages.
- Delete WebhookPermanently delete an organization-level webhook and stop future deliveries.
- Forward MessageImmediately forward an existing message to new recipients with optional added content and attachments.
- Release Held MessageRelease a message that Agent Armor held for review, emit its delivery and security override events, and remove the agent-armor-held label.
- Reply To MessageReply to a selected message while preserving its AgentMail thread.
- Respond to Calendar EventAccept, decline, or tentatively accept an email invitation on a US-only inbox calendar.
- Send DraftImmediately send and consume a draft, optionally changing message labels.
- Send EmailSend an email using AgentMail API
- Send MessageImmediately send a new email from an AgentMail inbox with optional HTML, attachments, custom headers, labels, and open tracking.
- Update CalendarChange an inbox calendar's default time zone in US production.
- Update Calendar EventPatch a US-only calendar event, one recurring date, or that date and future dates.
- Update DraftEdit a draft, reschedule delivery, or cancel a scheduled send with null.
- Update InboxUpdate an inbox's display name, status, or custom metadata.
- Update Inbox WebhookUpdate an inbox-scoped regular webhook's enabled state or replace its event types.
- Update Inbox Webhook HeadersAtomically set, replace, or remove custom delivery headers on an inbox-scoped regular webhook.
- Update Message LabelsAdd or remove labels from one message in an inbox.
- Update Pod InboxUpdate the display name, active or paused status, or metadata of an inbox inside an explicitly selected AgentMail pod.
- Update Thread LabelsAdd or remove custom labels from every message in one thread.
- Update WebhookUpdate an organization-level webhook's enabled state, event types, or inbox and pod subscriptions.
- Update Webhook HeadersAtomically set, replace, or remove custom delivery headers on an organization-level webhook.