AgentMail
Send and receive email programmatically.
OutboundAPI key23 endpoints
Endpoints
| Operation | Method & path | Effect | Latency | Rate | Cost |
|---|---|---|---|---|---|
AGENT_MAIL_CREATE_DRAFT Create a draft, optionally scheduling its automatic delivery with send_at. | POST /composio/agent_mail/agent_mail_create_draft | external_send | — | — | managed |
AGENT_MAIL_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. | POST /composio/agent_mail/agent_mail_create_inbox | external_send | — | — | managed |
AGENT_MAIL_CREATE_INBOX_API_KEY Create an inbox-scoped bearer key and return its one-time secret. Omitting permissions grants all permissions available within the inbox scope. | POST /composio/agent_mail/agent_mail_create_inbox_api_key | external_send | — | — | managed |
AGENT_MAIL_DELETE_THREAD Permanently delete one AgentMail thread and all of its messages. | POST /composio/agent_mail/agent_mail_delete_thread | external_send | — | — | managed |
AGENT_MAIL_GET_API_KEY Retrieve API-key metadata without exposing bearer secret values. | GET /composio/agent_mail/agent_mail_get_api_key | none | — | — | managed |
AGENT_MAIL_GET_DRAFT Retrieve the complete contents and scheduling details of one draft. | GET /composio/agent_mail/agent_mail_get_draft | none | — | — | managed |
AGENT_MAIL_GET_INBOX Retrieve one AgentMail inbox and its metadata by ID or email address. | GET /composio/agent_mail/agent_mail_get_inbox | none | — | — | managed |
AGENT_MAIL_GET_MESSAGE 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 /composio/agent_mail/agent_mail_get_message | none | — | — | managed |
AGENT_MAIL_GET_THREAD Retrieve one AgentMail thread and a paginated page of its messages. | GET /composio/agent_mail/agent_mail_get_thread | none | — | — | managed |
AGENT_MAIL_LIST_DRAFTS List unsent drafts in an AgentMail inbox with filters and pagination. | GET /composio/agent_mail/agent_mail_list_drafts | none | — | — | managed |
AGENT_MAIL_LIST_INBOX_API_KEYS List API-key metadata scoped to an inbox without exposing secret values. | GET /composio/agent_mail/agent_mail_list_inbox_api_keys | none | — | — | managed |
AGENT_MAIL_LIST_INBOXES List all inboxes available to the authenticated AgentMail account. Use this to discover valid inbox_id values for message operations. | GET /composio/agent_mail/agent_mail_list_inboxes | none | — | — | managed |
Showing 12 of 23 AgentMail actions. Every action is in the provider catalog, and the CLI and MCP list them with their inputs.