For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
contact@agentmail.ccDiscord
DocumentationAPI ReferenceKnowledge BaseChangelog
DocumentationAPI ReferenceKnowledge BaseChangelog
  • Get Started
    • Welcome
    • Introduction
    • Quickstart
  • Core Concepts
    • Inboxes
    • Messages
    • Threads
    • Drafts
    • Labels
    • Lists
    • Attachments
    • Pods
    • Permissions
  • Integrations
    • Agent Onboarding
    • Skills
    • MCP
    • CLI
    • Google ADK
    • OpenClaw
    • Replit
    • x402
    • MPP
    • LiveKit
    • Sim.ai
  • Guides
    • Sending & Receiving Email
    • IMAP & SMTP
    • Multi-Tenancy
  • Webhooks
    • Overview
    • Events
    • Setup Guide
    • Verifying Webhooks
  • WebSockets
    • Overview
    • Quickstart
  • Best Practices
    • Email Deliverability
    • Idempotency
  • Examples
    • Github Repo Agent
    • Auto Reply Agent
    • Smart Labeling Agent
    • Sales Agent (WebSocket)
    • Live AgentMail Examples
  • Resources
    • FAQ
    • Talon Reply Extraction
    • Community
    • Support
LogoLogo
contact@agentmail.ccDiscord
On this page
  • Getting started
  • Use cases
  • Prerequisites
  • Setup
  • Available operations
  • Inbox management
  • Message operations
  • Thread management
  • Draft management
  • Resources
Integrations

Sim.ai

Connect AgentMail to your Sim.ai workflows
Was this page helpful?
Edit this page
Previous

Guide: Sending & Receiving Email

Building your first conversational agent workflow.
Next
Built with

Getting started

Sim.ai is a platform for building agentic workflows. By connecting AgentMail to Sim, your workflows can create inboxes, send and receive emails, manage threads, handle drafts, and organize conversations with labels, all without writing backend code.

Use cases

  • Dynamic inbox creation: Spin up new inboxes on the fly for each agent, workflow, or customer 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 automated workflows.
  • Draft and review workflows: Create drafts, update them with AI-generated content, and send when approved for human-in-the-loop patterns.
  • Email organization: Apply labels to threads and messages to categorize, filter, and route emails through your automation pipeline.

Prerequisites

  1. An AgentMail account with an API key from the AgentMail Console
  2. A Sim.ai account

Setup

  1. Open your workflow in the Sim builder.
  2. Add the AgentMail block from the tools panel.
  3. Paste your AgentMail API key into the configuration.
  4. Select the operation you need (for example, create inbox, send message, or list threads).
  5. Map the input fields to your workflow data and connect the block to the rest of your flow.

Available operations

Once connected, Sim provides access to the following AgentMail operations:

Inbox management

OperationDescription
Create inboxCreate a new inbox with an optional username, domain, and display name
Get inboxRetrieve details for a specific inbox
Delete inboxDelete an inbox

Message operations

OperationDescription
Send messageSend a new email from an inbox
Get messageRetrieve details of a specific message
Reply to messageReply to an existing message in a thread
Forward messageForward a message to new recipients

Thread management

OperationDescription
Get threadRetrieve a thread and its messages
Delete threadDelete a thread (moves to trash, or permanently deletes if already in trash)

Draft management

OperationDescription
Create draftCreate a new email draft in an inbox
Get draftRetrieve details of a specific draft
Delete draftDelete a draft

Resources

  • Sim.ai AgentMail tool documentation
  • AgentMail API reference
  • Webhooks overview