Email inboxes for AI agents: create and list inboxes, read messages and threads, send and reply, and manage drafts.
Explore 18 workflow actions for AgentMail, including account permissions and operation limits.
9 read actions9 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Create draft
Write
Save a draft, optionally as a reply and optionally scheduled with send_at. Nothing is sent until it is sent or its time comes.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Operation limits
NodeHub sends its idempotency key as client_id, so a retried create returns the same draft. A draft with send_at is sent by AgentMail at that time.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create inbox
Write
Create an inbox, with a chosen or random address on agentmail.to or a verified domain.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Operation limits
NodeHub sends its idempotency key as client_id, so a retried create returns the same inbox instead of a second one.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete draft
Write
Delete a draft (and cancel its scheduled send).
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete inbox
Write
Delete an inbox and its mail.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Operation limits
A deleted inbox cannot be restored.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete webhook
Write
Delete an organization webhook so it stops receiving events.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get draft
Read
Read one draft.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Get inbox
Read
Read one inbox.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Get message
Read
Read one message with its text, HTML and the reply text AgentMail extracted.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Operation limits
Attachment contents and raw messages are not fetched (they come as signed links).
Get thread
Read
Read one conversation with its messages.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
List drafts
Read
List drafts in an inbox, including scheduled sends.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List inboxes
Read
List the organization's inboxes, newest first.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List messages
Read
List messages in an inbox, newest first, with optional label, time, sender, recipient and subject filters.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Operation limits
Filtered lists are served by AgentMail's search, which caps limit at 100.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List threads
Read
List conversations in an inbox, most recent first, with optional filters.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Operation limits
Filtered lists are served by AgentMail's search, which caps limit at 100.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List webhooks
Read
List the organization's webhooks and the events each receives. Signing secrets are left out.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Reply to message
Write
Reply to a message from the inbox it is in, in the same thread.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Operation limits
Sent once. A lost answer is not resent, so the email is never sent twice by NodeHub; check the inbox's sent messages before trying again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send draft
Write
Send a draft now. The draft becomes a sent message.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Operation limits
Sent once. A lost answer is not resent, so the email is never sent twice by NodeHub; check the inbox's sent messages before trying again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send message
Write
Send a new email from an inbox.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
Operation limits
Sent once. A lost answer is not resent, so the email is never sent twice by NodeHub; check the inbox's sent messages before trying again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update draft
Write
Change a draft's recipients, subject, body, attachments, labels or scheduled time.
Permissions and limits
Account permissions
An AgentMail API key with access to the inbox
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in AgentMail. A saved workflow is not a completed provider action.
