- Category: email
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 93
- Triggers: 1
- Slug:
AGENT_MAIL - Version: 20261101_00
Tools
Batch Get Messages
Batch Get Messages
AGENT_MAIL_BATCH_GET_MESSAGESReturn 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.Input Parameters
Output
Batch Update Message Labels
Batch Update Message Labels
AGENT_MAIL_BATCH_UPDATE_MESSAGE_LABELSAtomically 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.Input Parameters
Output
Complete File Upload
Complete File Upload
AGENT_MAIL_COMPLETE_FILE_UPLOADMark 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.Input Parameters
Output
Create Agent Armor Feedback
Create Agent Armor Feedback
AGENT_MAIL_CREATE_AGENT_ARMOR_FEEDBACKRecord whether Agent Armor’s completed verdict on a message was correct. A message accepts up to 20 feedback records.Input Parameters
Output
Create Calendar Event
Create Calendar Event
Create Draft
Create Draft
Create File
Create File
AGENT_MAIL_CREATE_FILEInitialize 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.Input Parameters
Output
Create Inbox
Create Inbox
AGENT_MAIL_CREATE_INBOXCreate 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.Input Parameters
Output
Create Inbox API Key
Create Inbox API Key
AGENT_MAIL_CREATE_INBOX_API_KEYCreate an inbox-scoped bearer key and return its one-time secret. Permissions can be specified to restrict the key.Input Parameters
Output
Create Inbox in Pod
Create Inbox in Pod
AGENT_MAIL_CREATE_INBOX_IN_PODCreate an inbox inside an explicitly selected AgentMail pod, optionally choosing its address, initial status, idempotency ID, and metadata.Input Parameters
Output
Create Inbox Polling Webhook
Create Inbox Polling Webhook
AGENT_MAIL_CREATE_INBOX_POLLING_WEBHOOKCreate 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.Input Parameters
Output
Create Inbox Webhook
Create Inbox Webhook
AGENT_MAIL_CREATE_INBOX_WEBHOOKCreate 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.Input Parameters
Output
Create Allowlist or Blocklist Entry
Create Allowlist or Blocklist Entry
Create Pod
Create Pod
Create Polling Webhook
Create Polling Webhook
AGENT_MAIL_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. 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.Input Parameters
Output
Create Webhook
Create Webhook
AGENT_MAIL_CREATE_WEBHOOKCreate 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.Input Parameters
Output
Delete Calendar Event
Delete Calendar Event
Delete Draft
Delete Draft
Delete File
Delete File
AGENT_MAIL_DELETE_FILEPermanently 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.Input Parameters
Output
Delete Inbox
Delete Inbox
Delete Inbox Polling Webhook
Delete Inbox Polling Webhook
AGENT_MAIL_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. 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.Input Parameters
Output
Delete Inbox Webhook
Delete Inbox Webhook
Delete Allowlist or Blocklist Entry
Delete Allowlist or Blocklist Entry
Delete Message
Delete Message
Delete Pod
Delete Pod
Delete Pod Inbox
Delete Pod Inbox
Delete Polling Webhook
Delete Polling Webhook
AGENT_MAIL_DELETE_POLLING_WEBHOOKPermanently 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.Input Parameters
Output
Delete Thread
Delete Thread
Delete Webhook
Delete Webhook
Forward Message
Forward Message
AGENT_MAIL_FORWARD_MESSAGEImmediately 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.Input Parameters
Output
Get Agenda
Get Agenda
Get API Key
Get API Key
Get Calendar
Get Calendar
Get Calendar Event
Get Calendar Event
Get Current Identity
Get Current Identity
Get Domain
Get Domain
Get Domain Setup Link
Get Domain Setup Link
Get Domain Zone File
Get Domain Zone File
Get Draft
Get Draft
Get Draft Attachment
Get Draft Attachment
Get File
Get File
Get Inbox
Get Inbox
Get Inbox Polling Webhook
Get Inbox Polling Webhook
AGENT_MAIL_GET_INBOX_POLLING_WEBHOOKGet 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.Input Parameters
Output
Get Inbox Webhook
Get Inbox Webhook
Get Inbox Webhook Headers
Get Inbox Webhook Headers
Get Message
Get Message
AGENT_MAIL_GET_MESSAGERetrieve 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.Input Parameters
Output
Get Message Attachment
Get Message Attachment
AGENT_MAIL_GET_MESSAGE_ATTACHMENTGet 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.Input Parameters
Output
Get Organization
Get Organization
Get Pod Inbox
Get Pod Inbox
Get Polling Webhook
Get Polling Webhook
AGENT_MAIL_GET_POLLING_WEBHOOKGet 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.Input Parameters
Output
Get Raw Message
Get Raw Message
AGENT_MAIL_GET_RAW_MESSAGEGet 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.Input Parameters
Output
Get Thread
Get Thread
Get Thread Attachment
Get Thread Attachment
AGENT_MAIL_GET_THREAD_ATTACHMENTGet 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.Input Parameters
Output
Get Webhook
Get Webhook
Get Webhook Headers
Get Webhook Headers
List Calendar Event Instances
List Calendar Event Instances
List Calendar Events
List Calendar Events
List Domains
List Domains
List Drafts
List Drafts
List Files
List Files
AGENT_MAIL_LIST_FILESList 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.Input Parameters
Output
List Inbox API Keys
List Inbox API Keys
List Inboxes
List Inboxes
AGENT_MAIL_LIST_INBOXESList 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.Input Parameters
Output
List Inbox Events
List Inbox Events
List Inbox Polling Webhooks
List Inbox Polling Webhooks
AGENT_MAIL_LIST_INBOX_POLLING_WEBHOOKSList 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.Input Parameters
Output
List Inbox Webhooks
List Inbox Webhooks
AGENT_MAIL_LIST_INBOX_WEBHOOKSList one page of regular webhooks created for a selected AgentMail inbox. Responses contain credential-sensitive signature secrets; never log or expose them.Input Parameters
Output
List Allowlist or Blocklist Entries
List Allowlist or Blocklist Entries
AGENT_MAIL_LIST_LIST_ENTRIESList one page of organization-wide send, receive, or reply allowlist or blocklist entries. Supply entry to retrieve one exact email address or domain.Input Parameters
Output
List Messages
List Messages
AGENT_MAIL_LIST_MESSAGESList messages from an AgentMail inbox. Returns a messages array; each message uses message_id and timestamp fields (not id, date, or items).Input Parameters
Output
List Pod Inboxes
List Pod Inboxes
AGENT_MAIL_LIST_POD_INBOXESList 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.Input Parameters
Output
List Pods
List Pods
List Polling Webhooks
List Polling Webhooks
AGENT_MAIL_LIST_POLLING_WEBHOOKSList 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.Input Parameters
Output
List Threads
List Threads
List Webhooks
List Webhooks
Query Inbox Event Metrics
Query Inbox Event Metrics
Query Metrics
Query Metrics
AGENT_MAIL_QUERY_METRICSQuery organization-wide email event counts or cumulative resource-usage time series over a bounded time range.Input Parameters
Output
Query Rate Metrics
Query Rate Metrics
Release Held Message
Release Held Message
Respond to Calendar Event
Respond to Calendar Event
Send Draft
Send Draft
Send Email
Send Email
AGENT_MAIL_SEND_EMAILSend an email using AgentMail APIInput Parameters
Output
Send Message
Send Message
AGENT_MAIL_SEND_MESSAGEImmediately 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.Input Parameters
Output
Update Calendar
Update Calendar
Update Calendar Event
Update Calendar Event
Update Draft
Update Draft
Update Inbox
Update Inbox
Update Inbox Webhook
Update Inbox Webhook
AGENT_MAIL_UPDATE_INBOX_WEBHOOKUpdate 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.Input Parameters
Output
Update Inbox Webhook Headers
Update Inbox Webhook Headers
AGENT_MAIL_UPDATE_INBOX_WEBHOOK_HEADERSAtomically 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.Input Parameters
Output
Update Message Labels
Update Message Labels
Update Pod Inbox
Update Pod Inbox
AGENT_MAIL_UPDATE_POD_INBOXUpdate the display name, active or paused status, or metadata of an inbox inside an explicitly selected AgentMail pod. Provide at least one field.Input Parameters
Output
Update Thread Labels
Update Thread Labels
AGENT_MAIL_UPDATE_THREAD_LABELSAdd 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.Input Parameters
Output
Update Webhook
Update Webhook
AGENT_MAIL_UPDATE_WEBHOOKUpdate 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.Input Parameters
Output
Update Webhook Headers
Update Webhook Headers
AGENT_MAIL_UPDATE_WEBHOOK_HEADERSAtomically 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.