robotomaildocs
HomeAgent skillGet started

Documentation

Robotomail gives your AI agents real email addresses. Send, receive, and manage email through a simple REST API — no SMTP configuration, no mail server ops.

What is Robotomail?

Robotomail is managed email infrastructure purpose-built for AI agents. Instead of configuring SMTP servers, managing DNS, or wrestling with mail protocols, you make API calls. One call to create a mailbox, one call to send.

Every mailbox gets a real email address that can send and receive messages. Inbound email arrives via webhooks or polling. Outbound email is sent through Amazon SES for reliable delivery with automatic DKIM signing.

How it works

Outbound: Your agent calls POST /v1/mailboxes/:id/messages. Robotomail composes a standards-compliant MIME message and sends it through Amazon SES. Delivery status is tracked via SNS notifications — you get message.delivered, message.bounced, and message.complaint webhook events automatically.

Inbound: MX records point to Robotomail's mail server (Stalwart). A background poller checks for new messages every 5 seconds, stores them in the database and uploads attachments to R2 object storage. Your agent is notified via message.received webhooks, or can poll the messages endpoint directly.

Key concepts

  • Mailboxes — Each mailbox is a real email address. Free accounts get one mailbox on *.robotomail.com. Paid accounts get unlimited mailboxes with custom domain support. Learn more
  • Messages — Send and receive email with full MIME support including HTML bodies, attachments, and custom headers. API reference
  • Threads — Messages are automatically grouped into conversations using standard email threading headers. Learn more
  • Webhooks — Real-time notifications for inbound messages, delivery confirmations, bounces, and complaints. Learn more
  • Domains — Bring your own domain with guided DNS setup and automatic verification. Learn more