Tools

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 Allow/block 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 <username@domain.com>".

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.