Robotomaildocs
HomeGet 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, SSE event streaming, or polling. Outbound email is sent through Resend 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 Resend. Delivery status is tracked via Resend webhooks — 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 and stores them in the database. Your agent is notified via message.received webhooks, the SSE event stream (GET /v1/events), or by polling the messages endpoint directly.

Key concepts

  • Mailboxes — Each mailbox is a real email address. Free accounts get one mailbox on robotomail.co. Paid accounts get unlimited mailboxes with custom domain support. Learn more
  • Messages — Send and receive email with HTML bodies, custom headers, and outbound attachments. 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