manage_domain
Create, verify, or delete a custom email domain. Use `action` to specify the operation:
- **create**: Register a new domain (returns DNS records to configure)
- **verify**: Trigger verification of DNS records for a pending domain
- **delete**: Remove a domain
Custom domains require a paid plan. After creating, configure the DNS records and then verify.
update_message_labels
Add or remove labels from an email message. Labels are used for organizing, filtering, and managing the state of conversations.
manage_draft
Create, update, or send an email draft. Use `action` to specify the operation:
- **create**: Create a new draft in an inbox
- **update**: Update an existing draft's content
- **send**: Send an existing draft as an email
Drafts support scheduling via `sendAt` for delayed sending.
list_drafts
List email drafts in an inbox. Returns draft metadata including subject, recipients, and scheduled send time. Supports pagination.
get_message
Retrieve the full details of a specific email message including headers, body content, attachments metadata, and extracted text. The `extractedText` and `extractedHtml` fields contain the reply content without quoted history.
get_inbox
Retrieve details of a specific email inbox by its ID, including its display name, pod association, and timestamps.
list_threads
List email conversation threads in an inbox. Threads group related messages together. Supports filtering by labels, date range, and pagination.
list_list_entries
List entries in an email allow or block list. Specify the direction (send/receive) and list type (allow/block) to view the corresponding list entries.
reply_to_email
Reply to an existing email message. Replies stay linked to the original thread. Use `replyAll` to reply to all original recipients. You can also add additional recipients via `to`, `cc`, and `bcc`.
get_attachment
Get a presigned download URL for an email attachment. The URL is temporary and expires after a set time. You can look up attachments from either a message or a thread.
list_pods
List all pods in the account. Pods are multi-tenant containers that group inboxes and domains for isolated email management. A default pod is created with every account.
list_messages
List email messages in an inbox with filtering by labels, date range, and inclusion of spam/blocked/trash. Supports pagination. Returns messages sorted by timestamp (newest first by default).
manage_pod
Create or delete a pod for multi-tenant isolation. Pods group inboxes and domains for a single customer/user/agent, keeping email data separate. A default pod is created when you sign up.
- **create**: Create a new pod
- **delete**: Delete an empty pod (all inboxes and domains must be removed first)
manage_webhook
Create, update, or delete webhooks for receiving email and domain events. Webhooks can be scoped to specific pods or inboxes.
Available event types: `message.received`, `message.sent`, `message.delivered`, `message.bounced`, `message.complained`, `message.rejected`, `domain.verified`.
manage_list_entry
Add or remove entries from email allow/block lists. Lists control which emails or domains can send to or receive from your inboxes. Specify `direction` (send or receive) and `listType` (allow or block) to target the correct list.
update_inbox
Update an inbox's display name. The display name format is typically "Display Name <[email protected]>".
get_thread
Retrieve a full email thread including all messages ordered by timestamp. Provides the complete conversation history with sender/recipient details, message content, and metadata.
delete_draft
Delete an email draft from an inbox. This permanently removes the draft.
delete_thread
Delete an email thread and all its messages from an inbox. This action cannot be undone.
send_email
Send a new email from an inbox. Supports plain text and HTML bodies, attachments (base64 or URL), CC/BCC recipients, custom headers, and labels. AgentMail handles SPF, DKIM, and DMARC automatically.
delete_inbox
Permanently delete an email inbox and all its associated data (messages, threads, drafts). This action cannot be undone.
list_domains
List all custom email domains in the account with their verification status and DNS records. Supports pagination.
list_inboxes
List all email inboxes in the account. Supports cursor-based pagination. Returns inboxes sorted by creation date (newest first by default).
create_inbox
Create a new email inbox for an AI agent. The inbox can use the default `@agentmail.to` domain or a custom domain (requires a paid plan). If no username is provided, one will be auto-generated.
forward_email
Forward an existing email message to new recipients. The original message content is included and you can add additional text or recipients.