Steps your experts and workflows can take in AgentMail.
Create Draft
Create a draft email for review or scheduled sending. Use send_at for automatic future delivery.
Create Inbox
Create a new email inbox for an AI agent via AgentMail. Each inbox gets a unique address and can send/receive emails.
Create List Entry
Add an email address or domain to an allow/block list. Block spam senders or whitelist trusted domains.
Create Pod
Create a new pod for multi-tenant customer isolation. Use client_id to map to your internal tenant IDs.
Create Pod Inbox
Create a new email inbox within a pod. The inbox is scoped to the customer workspace.
Delete Draft
Delete a draft or cancel a scheduled email. Removes the draft permanently.
Delete Inbox
Permanently delete an AgentMail inbox and all its messages, threads, and drafts. This action cannot be undone.
Delete Inbox Thread
Permanently delete a conversation thread and all its messages. This action cannot be undone.
Delete List Entry
Remove an email address or domain from an allow/block list to stop filtering it.
Delete Pod
Permanently delete a pod. All inboxes and domains must be removed first.
Forward Message
Forward an email message to one or more recipients. Supports CC/BCC and optional extra text or subject override.
Get Draft
Retrieve a draft email to review its contents, recipients, and scheduled send status.
Get Inbox
Retrieve details of an existing AgentMail inbox including its email address, display name, and configuration.
Get Inbox Thread
Retrieve a conversation thread with all its messages. Use for getting full conversation context before replying.
Get List Entry
Check if an email address or domain is in an allow/block list. Verify filtering rules.
Get Message
Retrieve a specific email message by ID. Includes extracted_text for clean reply content without quoted history.
Get Message Attachment
Download a file attachment from an email message. Returns base64-encoded file content.
Get Org Thread
Retrieve a conversation thread by ID from anywhere in the organization, without needing the inbox ID.
Get Pod
Retrieve details of an existing pod including its client_id mapping and metadata.
Get Thread Attachment
Download a file attachment from a conversation thread. Returns base64-encoded file content.
List Drafts
List drafts in an AgentMail inbox. Filter by labels=['scheduled'] to find pending sends.
List Entries
List all entries in an AgentMail allow/block list. Choose send/receive direction and allow/block type.
List Inbox Threads
List all conversation threads in an AgentMail inbox. Filter by labels for campaign tracking or status management.
List Inboxes
List all email inboxes in your AgentMail organization with pagination support.
List Messages
List messages in an AgentMail inbox. Filter by labels to find unread, campaign-tagged, or categorized messages.
List Org Drafts
List all drafts across every inbox in your organization. Use for central approval dashboards.
List Org Threads
List threads across ALL inboxes in your organization. Use for supervisor agents, dashboards, or cross-agent monitoring.
List Pod Drafts
List all drafts across all inboxes within a pod. View pending emails for a customer.
List Pod Inboxes
List all inboxes within a pod. View email accounts scoped to a specific customer.
List Pod Threads
List all conversation threads across all inboxes within a pod. View all email activity for a customer.
List Pods
List all tenant pods in your organization. See all customer workspaces at a glance.
Reply To Message
Reply to an existing email in the same conversation thread. Use for multi-turn agent conversations.
Send Draft
Send a draft immediately, converting it into a delivered message. The draft is deleted after sending.
Send Message
Send a new email from an AgentMail inbox. Creates a new conversation thread. Supports HTML, CC/BCC, and labels.
Update Draft
Update a draft's content, recipients, or scheduled send time. Use to reschedule or edit before sending.
Update Inbox
Update the display name of an AgentMail inbox. Changes the 'From' name shown when emails are sent.
Update Message
Add or remove labels on an email message. Use for read/unread tracking, campaign tagging, or state management.