New Email Received
Trigger for new emails in an AgentMail inbox
TriggerpollTry it
Integrate Agent Mail
with your AI CRM
AgentMail provides programmable email inboxes, messages, drafts, domains, webhooks, and related infrastructure for AI agents.
Explore Triggers and Actions
Batch Get Messages
Return metadata for up to 500 messages from one inbox in a single request. Compare count with limit to detect missing or restricted IDs. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.
ActionTry it
Batch Update Message Labels
Atomically add or remove the same labels on up to 50 messages in one inbox. Missing or restricted message IDs are omitted from the result. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.
ActionTry it
Complete File Upload
Mark a pending Agent Drive file ready after its bytes have been PUT to the presigned URL returned by CREATE_FILE. AgentMail verifies the exact declared size and SHA-256; calling this before a successful upload returns a conflict. Only a key with file_read or the key that created the file can complete it. Agent Drive is a US-production-only Labs feature.
ActionTry it
Create Agent Armor Feedback
Record whether Agent Armor's completed verdict on a message was correct. A message accepts up to 20 feedback records.
ActionTry it
Create Allowlist or Blocklist Entry
Add an email address or domain to an organization-wide send, receive, or reply allowlist or blocklist.
ActionTry it
Create Calendar Event
Create a one-off or recurring event on a US-only inbox calendar. client_id makes retries safe; send_invites emails attendees and consumes send limits.
ActionTry it
Create Draft
Create a draft, optionally scheduling its automatic delivery with send_at.
ActionTry it
Create File
Initialize a pending Agent Drive file and return instructions for a direct storage upload. This does not upload bytes: PUT the exact bytes to the credential-sensitive presigned URL with every returned header unchanged and without the AgentMail API key, then call COMPLETE_FILE_UPLOAD. Identical requests are retry-safe. Pending files consume Drive quota immediately and expire after one day if incomplete; call DELETE_FILE when abandoning an upload. Agent Drive is a US-production-only Labs feature.
ActionTry it
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.
ActionTry it
Create Inbox API Key
Create an inbox-scoped bearer key and return its one-time secret. Permissions can be specified to restrict the key.
ActionTry it
Create Inbox in Pod
Create an inbox inside an explicitly selected AgentMail pod, optionally choosing its address, initial status, idempotency ID, and metadata.
ActionTry it
Create Inbox Polling Webhook
Create or resume a polling webhook scoped to one inbox. The inbox comes from the path, so organization selector lists are not accepted. AgentMail's polling guide currently says polling is US-only even though the API reference lists an EU server; follow the guide and do not assume EU support. The response contains a one-time credential-sensitive polling token; store it securely and never log or expose it.
ActionTry it
Create Inbox Webhook
Create a regular webhook scoped to one AgentMail inbox for a non-empty set of event types. The response contains a credential-sensitive signature secret; never log or expose it.
ActionTry it
Create Pod
Create an AgentMail pod for grouping inboxes and related resources.
ActionTry it
Create Polling Webhook
Create or resume an organization-level polling webhook for a non-empty set of event types, optionally filtered to at most 10 inboxes and pods combined. Current provider polling support is US-only (api.agentmail.to); do not use this action with an EU connection. The response contains a one-time, credential-sensitive polling token; store it securely and never log or expose it.
ActionTry it
Create Webhook
Create an organization-level webhook for a non-empty set of event types, optionally filtered to at most 10 inboxes and pods combined. The response contains a credential-sensitive signature secret; never log or expose it.
ActionTry it
Delete Allowlist or Blocklist Entry
Remove one email address or domain from an organization-wide send, receive, or reply allowlist or blocklist.
ActionTry it
Delete Calendar Event
Accept asynchronous deletion of a US-only calendar event or cancel recurring dates. If-Match guards the version and Idempotency-Key makes retries deterministic.
ActionTry it
Delete Draft
Permanently delete one unsent draft from an inbox.
ActionTry it
Delete File
Permanently delete a pending or ready Agent Drive file and free its path. A previously issued presigned download URL can remain valid until its expiry. Requires file_delete, and only a key with file_read or the key that created the file can delete it. Agent Drive is a US-production-only Labs feature.
ActionTry it
Delete Inbox
Permanently delete one inbox by ID. AgentMail accepts the deletion asynchronously, so acceptance does not guarantee immediate completion.
ActionTry it
Delete Inbox Polling Webhook
Permanently delete an inbox-scoped polling webhook by webhook_id or client_id, invalidate its polling token, and free its subscription slot. AgentMail's polling guide currently says polling is US-only even though the API reference lists an EU server; follow the guide and do not assume EU support.
ActionTry it
Delete Inbox Webhook
Permanently delete a regular webhook created for a selected AgentMail inbox and stop future deliveries.
ActionTry it
Delete Message
Permanently delete one message from an inbox. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.
ActionTry it
Delete Pod
Permanently delete one AgentMail pod by its unique ID.
ActionTry it
Delete Pod Inbox
Permanently delete an inbox through its explicitly selected AgentMail pod, preserving the pod tenant boundary. A 202 response means deletion continues asynchronously; poll GET_POD_INBOX until it returns 404.
ActionTry it
Delete Polling Webhook
Permanently delete an organization-level polling webhook by webhook_id or client_id, invalidate its polling token, and free its subscription slot. Current provider polling support is US-only (api.agentmail.to); do not use this action with an EU connection.
ActionTry it
Delete Thread
Permanently delete one AgentMail thread and all of its messages.
ActionTry it
Delete Webhook
Permanently delete an organization-level webhook and stop future deliveries.
ActionTry it
Forward Message
Immediately forward an existing message to new recipients with optional added content and attachments. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.
ActionTry it
Get Agenda
Get one page of non-cancelled calendar dates in a UTC window, expanding recurring events and ordering dates by start time. Calendar is available only in US production.
ActionTry it
Get API Key
Retrieve API-key metadata without exposing bearer secret values.
ActionTry it
Get Calendar
Get an inbox's US-only calendar settings, event count, and ETag. Use primary consistency to read a just-completed write.
ActionTry it
Get Calendar Event
Get the full current form of a US-only calendar event or recurring-event date, including its opaque ETag for conditional mutations.
ActionTry it
Get Current Identity
Return the connected AgentMail identity and its organization, pod, or inbox access boundary without exposing the credential itself.
ActionTry it
Get Domain
Return an AgentMail custom domain, its domain and tracking verification statuses, and all required DNS records.
ActionTry it
Get Domain Setup Link
Build a one-click Domain Connect DNS setup link when supported. The returned signed URL must be delivered privately to the intended domain owner. Retain the sensitive state ephemerally and compare it on redirect; do not log either value.
ActionTry it
Get Domain Zone File
Download the AgentMail-generated DNS zone file for a custom domain as a bounded binary file reference.
ActionTry it
Get Draft
Retrieve the complete contents and scheduling details of one draft.
ActionTry it
Get Draft Attachment
Get a temporary download reference for one draft attachment.
ActionTry it
Get File
Get Agent Drive file metadata. A ready file can include a credential-sensitive presigned download URL valid for up to one hour; treat it as a secret and never log or expose it. Requires file_read. Agent Drive is a US-production-only Labs feature.
ActionTry it
Get Inbox
Retrieve one AgentMail inbox and its metadata by ID or email address.
ActionTry it
Get Inbox Polling Webhook
Get one inbox-scoped polling webhook by webhook_id or client_id. AgentMail's polling guide currently says polling is US-only even though the API reference lists an EU server; follow the guide and do not assume EU support. The polling token is never returned; create again with the same client_id to issue a new token.
ActionTry it
Get Inbox Webhook
Get one regular webhook created for a selected AgentMail inbox. The response contains a credential-sensitive signature secret; never log or expose it.
ActionTry it
Get Inbox Webhook Headers
List only the names of custom delivery headers on an inbox-scoped regular webhook. Header values are credential-sensitive, write-only, and never returned.
ActionTry it
Get Message
Retrieve an email message from an AgentMail inbox, including sender, recipients, labels, and available subject, body and attachment metadata. Use it to read individual messages discovered through message listing or webhooks.
ActionTry it
Get Message Attachment
Get a temporary download reference for one message attachment. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.
ActionTry it
Get Organization
Return the connected AgentMail organization's identifiers, current inbox and domain counts, configured resource limits, and timestamps.
ActionTry it
Get Pod
Retrieve one AgentMail pod by its unique ID.
ActionTry it
Get Pod Inbox
Get an AgentMail inbox through an explicitly selected pod, preserving the pod tenant boundary.
ActionTry it
Get Polling Webhook
Get one organization-level polling webhook by webhook_id or client_id. Current provider polling support is US-only (api.agentmail.to); do not use this action with an EU connection. The polling token is never returned; create again with the same client_id to issue a new token.
ActionTry it
Get Raw Message
Get a temporary download reference for one message's raw RFC 5322 source, including its original headers and MIME structure. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.
ActionTry it
Get Thread
Retrieve one AgentMail thread and a paginated page of its messages.
ActionTry it
Get Thread Attachment
Get a temporary download reference for an attachment using its thread and attachment IDs. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.
ActionTry it
Get Webhook
Get one organization-level webhook configuration by ID. The response contains a credential-sensitive signature secret; never log or expose it.
ActionTry it
Get Webhook Headers
List only the names of custom delivery headers on an organization-level webhook. Header values are credential-sensitive, write-only, and never returned.
ActionTry it
List Allowlist or Blocklist Entries
List one page of organization-wide send, receive, or reply allowlist or blocklist entries. Supply entry to retrieve one exact email address or domain.
ActionTry it
List Calendar Event Instances
List one page of non-cancelled dates computed for a recurring US-only calendar event in a UTC window, including dates beyond the agenda horizon.
ActionTry it
List Calendar Events
List one US-only calendar page of stored one-off events, recurring series, and edited series dates, including cancelled events, by most recent update.
ActionTry it
List Domains
List one page of AgentMail custom domains and return the continuation token for the next page.
ActionTry it
List Drafts
List unsent drafts in an AgentMail inbox with filters and pagination.
ActionTry it
List Files
List one page of an inbox's Agent Drive files in path order, including pending files. List items intentionally contain no presigned download URL; call GET_FILE for one. Requires file_read. Agent Drive is a US-production-only Labs feature.
ActionTry it
List Inbox API Keys
List API-key metadata scoped to an inbox without exposing secret values.
ActionTry it
List Inbox Events
List label-change events from an AgentMail inbox.
ActionTry it
List Inbox Polling Webhooks
List polling webhooks created through one inbox route. Returns one page and an endpoint- and inbox-bound opaque continuation token. AgentMail's polling guide currently says polling is US-only even though the API reference lists an EU server; follow the guide and do not assume EU support. Polling tokens are never returned.
ActionTry it
List Inbox Webhooks
List one page of regular webhooks created for a selected AgentMail inbox. Responses contain credential-sensitive signature secrets; never log or expose them.
ActionTry it
List Inboxes
List a page of inboxes available to the authenticated AgentMail account. Use this to discover inbox_id values for message operations; follow the next page token to retrieve more results.
ActionTry it
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`).
ActionTry it
List Pod Inboxes
List one page of inboxes inside an explicitly selected AgentMail pod, or supply query to search addresses and display names. Follow next_page_token until absent, including after an empty search page.
ActionTry it
List Pods
Return one page of AgentMail pods and its continuation token.
ActionTry it
List Polling Webhooks
List organization-level polling webhooks created through the organization route. Returns one page and an endpoint-bound opaque continuation token. Current provider polling support is US-only (api.agentmail.to); do not use this action with an EU connection. Polling tokens are never returned.
ActionTry it
List Threads
List conversation threads in an AgentMail inbox with filters.
ActionTry it
List Webhooks
List AgentMail webhook configurations.
ActionTry it
Query Inbox Event Metrics
Query timestamped email-event counts for an AgentMail inbox.
ActionTry it
Query Metrics
Query organization-wide email event counts or cumulative resource-usage time series over a bounded time range.
ActionTry it
Query Rate Metrics
Query organization-wide rolling bounce and complaint rates.
ActionTry it
Release Held Message
Release a message that Agent Armor held for review, emit its delivery and security override events, and remove the agent-armor-held label. Only a still-held message with a review verdict can be released.
ActionTry it
Reply To Message
Reply to a selected message while preserving its AgentMail thread.
ActionTry it
Respond to Calendar Event
Accept, decline, or tentatively accept an email invitation on a US-only inbox calendar. By default AgentMail emails the organizer; If-Match guards the response.
ActionTry it
Send Draft
Immediately send and consume a draft, optionally changing message labels.
ActionTry it
Send Email
Send an email using AgentMail API
ActionTry it
Send Message
Immediately send a new email from an AgentMail inbox with optional HTML, attachments, custom headers, labels, and open tracking. Use a draft instead when the message must be scheduled for later.
ActionTry it
Update Calendar
Change an inbox calendar's default time zone in US production. Existing events retain their own time zones; optionally guard the update with If-Match.
ActionTry it
Update Calendar Event
Patch a US-only calendar event, one recurring date, or that date and future dates. Explicit null clears only documented nullable fields; If-Match prevents overwrites.
ActionTry it
Update Draft
Edit a draft, reschedule delivery, or cancel a scheduled send with null.
ActionTry it
Update Inbox
Update an inbox's display name, status, or custom metadata.
ActionTry it
Update Inbox Webhook
Update an inbox-scoped regular webhook's enabled state or replace its event types. An empty update is allowed. The response contains a credential-sensitive signature secret; never log or expose it.
ActionTry it
Update Inbox Webhook Headers
Atomically set, replace, or remove custom delivery headers on an inbox-scoped regular webhook. At least one real header change is required. Header values are credential-sensitive and write-only; never log or expose them.
ActionTry it
Update Message Labels
Add or remove labels from one message in an inbox. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.
ActionTry it
Update Pod Inbox
Update the display name, active or paused status, or metadata of an inbox inside an explicitly selected AgentMail pod. Provide at least one field.
ActionTry it
Update Thread Labels
Add or remove custom labels from every message in one thread. Source or target records with spam, blocked, unauthenticated, or trash labels may be hidden or reported not found when the API key lacks the corresponding label visibility permission.
ActionTry it
Update Webhook
Update an organization-level webhook's enabled state, event types, or inbox and pod subscriptions. An empty update is allowed. The response contains a credential-sensitive signature secret; never log or expose it.
ActionTry it
Update Webhook Headers
Atomically set, replace, or remove custom delivery headers on an organization-level webhook. At least one real header change is required. Header values are credential-sensitive and write-only; never log or expose them.
ActionTry it
How the Agent Mail integration works
The Agent Mail integration connects your Dench AI CRM directly to Agent Mail, so agents can read and act on your Agent Mail data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
93 actions are available for agents to invoke on your behalf, and 1 trigger can start a Dench automation the moment something changes in Agent Mail. Every call runs through Agent Mail's own authorization, scoped to the account you connect.
Set up Agent Mail in Dench
- 1
Sign in to your Dench workspace and open Integrations.
- 2
Find Agent Mail and click Connect — you'll authorize access through Agent Mail's own sign-in flow. No API keys or code required.
- 3
Ask an agent to use Agent Mail in chat, or wire a Agent Mail trigger into an automation.
- 4
Manage or disconnect the connection any time from workspace settings.
Frequently asked questions
How does the Agent Mail integration work with Dench?
The Dench Agent Mail integration connects your AI CRM to Agent Mail, so AI agents can work with your Agent Mail data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
What actions can AI agents perform with Agent Mail via Dench?
The Agent Mail integration currently exposes 93 actions, including Batch Get Messages, Batch Update Message Labels, Complete File Upload, Create Agent Armor Feedback, Create Allowlist or Blocklist Entry, and Create Calendar Event. Agents invoke them on your behalf from chat or from automations.
Can Dench react to events in Agent Mail automatically?
Yes. The Agent Mail integration provides 1 trigger — such as New Email Received — that can start a Dench automation the moment something happens in Agent Mail.
Do I need to write code to connect Agent Mail to Dench?
No. You connect Agent Mail from your Dench workspace using Agent Mail's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Is the Agent Mail integration secure?
Connections are authorized through Agent Mail's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Agent Mail connection from your workspace settings at any time.