AgentMail
Send and receive email programmatically.
OutboundAPI key15 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_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 |
AGENT_MAIL_LIST_INBOX_EVENTS List label-change events from an AgentMail inbox. | GET /composio/agent_mail/agent_mail_list_inbox_events | none | — | — | managed |
AGENT_MAIL_LIST_MESSAGES List messages from an AgentMail inbox. Returns a `messages` array; each message uses `message_id` and `timestamp` fields (not `id`, `date`, or `items`). | GET /composio/agent_mail/agent_mail_list_messages | none | — | — | managed |
AGENT_MAIL_LIST_THREADS List conversation threads in an AgentMail inbox with filters. | GET /composio/agent_mail/agent_mail_list_threads | none | — | — | managed |
AGENT_MAIL_QUERY_INBOX_EVENT_METRICS Query timestamped email-event counts for an AgentMail inbox. | POST /composio/agent_mail/agent_mail_query_inbox_event_metrics | external_send | — | — | managed |
AGENT_MAIL_SEND_DRAFT Immediately send and consume a draft, optionally changing message labels. | POST /composio/agent_mail/agent_mail_send_draft | external_send | — | — | managed |
AGENT_MAIL_SEND_EMAIL Send an email using AgentMail API | POST /composio/agent_mail/agent_mail_send_email | external_send | — | — | managed |
AGENT_MAIL_UPDATE_DRAFT Edit a draft, reschedule delivery, or cancel a scheduled send with null. | POST /composio/agent_mail/agent_mail_update_draft | external_send | — | — | managed |