AgentMail

Manage email inboxes, threads, and messages with AgentMail

AgentMail is an API-first email platform built for agents and automation. AgentMail lets you create email inboxes on the fly, send and receive messages, reply to threads, manage drafts, and organize conversations with labels — all through a simple REST API designed for programmatic access.

Why AgentMail?

  • Agent-Native Email: Purpose-built for AI agents and automation — create inboxes, send messages, and manage threads without human-facing UI overhead.
  • Full Email Lifecycle: Send new messages, reply to threads, forward emails, manage drafts, and schedule sends — all from a single API.
  • Thread & Conversation Management: Organize emails into threads with full read, reply, forward, and label support for structured conversation tracking.
  • Draft Workflow: Compose drafts, update them, schedule sends, and dispatch when ready — perfect for review-before-send workflows.
  • Label Organization: Tag threads and messages with custom labels for filtering, routing, and downstream automation.

Using AgentMail in Sim

Sim's AgentMail integration connects your agentic workflows directly to AgentMail using an API key. With 20 operations spanning inboxes, threads, messages, and drafts, you can build powerful email automations without writing backend code.

Key benefits of using AgentMail in Sim:

  • Dynamic inbox creation: Spin up new inboxes on the fly for each agent, workflow, or customer — perfect for multi-tenant email handling.
  • Automated email processing: List and read incoming messages, then trigger downstream actions based on content, sender, or labels.
  • Conversational email: Reply to threads and forward messages to keep conversations flowing naturally within your automated workflows.
  • Draft and review workflows: Create drafts, update them with AI-generated content, and send when approved — ideal for human-in-the-loop patterns.
  • Email organization: Apply labels to threads and messages to categorize, filter, and route emails through your automation pipeline.

Whether you're building an AI email assistant, automating customer support replies, processing incoming leads, or managing multi-agent email workflows, AgentMail in Sim gives you direct, secure access to the full AgentMail API — no middleware required. Simply configure your API key, select the operation you need, and let Sim handle the rest.

Usage Instructions

Integrate AgentMail into your workflow. Create and manage email inboxes, send and receive messages, reply to threads, manage drafts, and organize threads with labels. Requires API Key.

Tools

agentmail_create_draft

Create a new email draft in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to create the draft in
tostringNoRecipient email addresses (comma-separated)
subjectstringNoDraft subject line
textstringNoPlain text draft body
htmlstringNoHTML draft body
ccstringNoCC recipient email addresses (comma-separated)
bccstringNoBCC recipient email addresses (comma-separated)
inReplyTostringNoID of message being replied to
sendAtstringNoISO 8601 timestamp to schedule sending

Output

ParameterTypeDescription
draftIdstringUnique identifier for the draft
inboxIdstringInbox the draft belongs to
subjectstringDraft subject
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
textstringPlain text content
htmlstringHTML content
previewstringDraft preview text
labelsarrayLabels assigned to the draft
inReplyTostringMessage ID this draft replies to
sendStatusstringSend status (scheduled, sending, failed)
sendAtstringScheduled send time
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_create_inbox

Create a new email inbox with AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
usernamestringNoUsername for the inbox email address
domainstringNoDomain for the inbox email address
displayNamestringNoDisplay name for the inbox

Output

ParameterTypeDescription
inboxIdstringUnique identifier for the inbox
emailstringEmail address of the inbox
displayNamestringDisplay name of the inbox
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_delete_draft

Delete an email draft in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the draft
draftIdstringYesID of the draft to delete

Output

ParameterTypeDescription
deletedbooleanWhether the draft was successfully deleted

agentmail_delete_inbox

Delete an email inbox in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to delete

Output

ParameterTypeDescription
deletedbooleanWhether the inbox was successfully deleted

agentmail_delete_thread

Delete an email thread in AgentMail (moves to trash, or permanently deletes if already in trash)

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the thread
threadIdstringYesID of the thread to delete
permanentbooleanNoForce permanent deletion instead of moving to trash

Output

ParameterTypeDescription
deletedbooleanWhether the thread was successfully deleted

agentmail_forward_message

Forward an email message to new recipients in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the message
messageIdstringYesID of the message to forward
tostringYesRecipient email addresses (comma-separated)
subjectstringNoOverride subject line
textstringNoAdditional plain text to prepend
htmlstringNoAdditional HTML to prepend
ccstringNoCC recipient email addresses (comma-separated)
bccstringNoBCC recipient email addresses (comma-separated)

Output

ParameterTypeDescription
messageIdstringID of the forwarded message
threadIdstringID of the thread

agentmail_get_draft

Get details of a specific email draft in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox the draft belongs to
draftIdstringYesID of the draft to retrieve

Output

ParameterTypeDescription
draftIdstringUnique identifier for the draft
inboxIdstringInbox the draft belongs to
subjectstringDraft subject
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
textstringPlain text content
htmlstringHTML content
previewstringDraft preview text
labelsarrayLabels assigned to the draft
inReplyTostringMessage ID this draft replies to
sendStatusstringSend status (scheduled, sending, failed)
sendAtstringScheduled send time
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_get_inbox

Get details of a specific email inbox in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to retrieve

Output

ParameterTypeDescription
inboxIdstringUnique identifier for the inbox
emailstringEmail address of the inbox
displayNamestringDisplay name of the inbox
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_get_message

Get details of a specific email message in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the message
messageIdstringYesID of the message to retrieve

Output

ParameterTypeDescription
messageIdstringUnique identifier for the message
threadIdstringID of the thread this message belongs to
fromstringSender email address
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
subjectstringMessage subject
textstringPlain text content
htmlstringHTML content
createdAtstringCreation timestamp

agentmail_get_thread

Get details of a specific email thread including messages in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the thread
threadIdstringYesID of the thread to retrieve

Output

ParameterTypeDescription
threadIdstringUnique identifier for the thread
subjectstringThread subject
sendersarrayList of sender email addresses
recipientsarrayList of recipient email addresses
messageCountnumberNumber of messages in the thread
labelsarrayLabels assigned to the thread
lastMessageAtstringTimestamp of last message
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
messagesarrayMessages in the thread
messageIdstringUnique identifier for the message
fromstringSender email address
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
subjectstringMessage subject
textstringPlain text content
htmlstringHTML content
createdAtstringCreation timestamp

agentmail_list_drafts

List email drafts in an inbox in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to list drafts from
limitnumberNoMaximum number of drafts to return
pageTokenstringNoPagination token for next page of results

Output

ParameterTypeDescription
draftsarrayList of drafts
draftIdstringUnique identifier for the draft
inboxIdstringInbox the draft belongs to
subjectstringDraft subject
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
previewstringDraft preview text
sendStatusstringSend status (scheduled, sending, failed)
sendAtstringScheduled send time
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
countnumberTotal number of drafts
nextPageTokenstringToken for retrieving the next page

agentmail_list_inboxes

List all email inboxes in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
limitnumberNoMaximum number of inboxes to return
pageTokenstringNoPagination token for next page of results

Output

ParameterTypeDescription
inboxesarrayList of inboxes
inboxIdstringUnique identifier for the inbox
emailstringEmail address of the inbox
displayNamestringDisplay name of the inbox
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
countnumberTotal number of inboxes
nextPageTokenstringToken for retrieving the next page

agentmail_list_messages

List messages in an inbox in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to list messages from
limitnumberNoMaximum number of messages to return
pageTokenstringNoPagination token for next page of results

Output

ParameterTypeDescription
messagesarrayList of messages in the inbox
messageIdstringUnique identifier for the message
fromstringSender email address
toarrayRecipient email addresses
subjectstringMessage subject
previewstringMessage preview text
createdAtstringCreation timestamp
countnumberTotal number of messages
nextPageTokenstringToken for retrieving the next page

agentmail_list_threads

List email threads in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to list threads from
limitnumberNoMaximum number of threads to return
pageTokenstringNoPagination token for next page of results
labelsstringNoComma-separated labels to filter threads by
beforestringNoFilter threads before this ISO 8601 timestamp
afterstringNoFilter threads after this ISO 8601 timestamp

Output

ParameterTypeDescription
threadsarrayList of email threads
threadIdstringUnique identifier for the thread
subjectstringThread subject
sendersarrayList of sender email addresses
recipientsarrayList of recipient email addresses
messageCountnumberNumber of messages in the thread
lastMessageAtstringTimestamp of last message
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
countnumberTotal number of threads
nextPageTokenstringToken for retrieving the next page

agentmail_reply_message

Reply to an existing email message in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to reply from
messageIdstringYesID of the message to reply to
textstringNoPlain text reply body
htmlstringNoHTML reply body
tostringNoOverride recipient email addresses (comma-separated)
ccstringNoCC email addresses (comma-separated)
bccstringNoBCC email addresses (comma-separated)
replyAllbooleanNoReply to all recipients of the original message

Output

ParameterTypeDescription
messageIdstringID of the sent reply message
threadIdstringID of the thread

agentmail_send_draft

Send an existing email draft in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the draft
draftIdstringYesID of the draft to send

Output

ParameterTypeDescription
messageIdstringID of the sent message
threadIdstringID of the thread

agentmail_send_message

Send an email message from an AgentMail inbox

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to send from
tostringYesRecipient email address (comma-separated for multiple)
subjectstringYesEmail subject line
textstringNoPlain text email body
htmlstringNoHTML email body
ccstringNoCC recipient email addresses (comma-separated)
bccstringNoBCC recipient email addresses (comma-separated)

Output

ParameterTypeDescription
threadIdstringID of the created thread
messageIdstringID of the sent message
subjectstringEmail subject line
tostringRecipient email address

agentmail_update_draft

Update an existing email draft in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the draft
draftIdstringYesID of the draft to update
tostringNoRecipient email addresses (comma-separated)
subjectstringNoDraft subject line
textstringNoPlain text draft body
htmlstringNoHTML draft body
ccstringNoCC recipient email addresses (comma-separated)
bccstringNoBCC recipient email addresses (comma-separated)
sendAtstringNoISO 8601 timestamp to schedule sending

Output

ParameterTypeDescription
draftIdstringUnique identifier for the draft
inboxIdstringInbox the draft belongs to
subjectstringDraft subject
toarrayRecipient email addresses
ccarrayCC email addresses
bccarrayBCC email addresses
textstringPlain text content
htmlstringHTML content
previewstringDraft preview text
labelsarrayLabels assigned to the draft
inReplyTostringMessage ID this draft replies to
sendStatusstringSend status (scheduled, sending, failed)
sendAtstringScheduled send time
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_update_inbox

Update the display name of an email inbox in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox to update
displayNamestringYesNew display name for the inbox

Output

ParameterTypeDescription
inboxIdstringUnique identifier for the inbox
emailstringEmail address of the inbox
displayNamestringDisplay name of the inbox
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp

agentmail_update_message

Add or remove labels on an email message in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the message
messageIdstringYesID of the message to update
addLabelsstringNoComma-separated labels to add to the message
removeLabelsstringNoComma-separated labels to remove from the message

Output

ParameterTypeDescription
messageIdstringUnique identifier for the message
labelsarrayCurrent labels on the message

agentmail_update_thread

Add or remove labels on an email thread in AgentMail

Input

ParameterTypeRequiredDescription
apiKeystringYesAgentMail API key
inboxIdstringYesID of the inbox containing the thread
threadIdstringYesID of the thread to update
addLabelsstringNoComma-separated labels to add to the thread
removeLabelsstringNoComma-separated labels to remove from the thread

Output

ParameterTypeDescription
threadIdstringUnique identifier for the thread
labelsarrayCurrent labels on the thread

On this page

Start building today
Trusted by over 100,000 builders.
The open-source platform to build AI agents and run your agentic workforce.
Get started