robotomaildocs
HomeAgent skillGet started

Quickstart

Go from zero to sending your first email in under 5 minutes.

Prerequisites

You need curl (or any HTTP client) and a terminal. No SDKs, packages, or configuration files required.

1. Create an account

Sign up with your email, a password, and a slug. The slug becomes your subdomain: *.robotomail.com.

curl
curl -X POST https://api.robotomail.com/v1/signup \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your-password",
    "slug": "myagent"
  }'

The response includes your API key. Save it now — it cannot be retrieved later.

response
{
  "user": { "id": "usr_...", "slug": "myagent", "plan": "free" },
  "api_key": { "key": "rm_a1b2c3...", "prefix": "rm_a1b2c", "name": "default" }
}

2. Save your API key

Export the key as an environment variable for the remaining steps:

shell
export ROBOTOMAIL_API_KEY="rm_a1b2c3..."

3. Create a mailbox

Create a mailbox to get a real email address. The address is formed as [email protected].

curl
curl -X POST https://api.robotomail.com/v1/mailboxes \
  -H "Authorization: Bearer $ROBOTOMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "address": "hello", "displayName": "My Agent" }'
response
{
  "mailbox": {
    "id": "mbx_...",
    "fullAddress": "[email protected]",
    "status": "ACTIVE",
    "dailySendLimit": 50
  }
}

4. Send your first email

Send an email from your new mailbox. Replace MAILBOX_ID with the id from the previous step.

curl
curl -X POST https://api.robotomail.com/v1/mailboxes/MAILBOX_ID/messages \
  -H "Authorization: Bearer $ROBOTOMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["[email protected]"],
    "subject": "Hello from my agent",
    "bodyText": "This email was sent by an AI agent via Robotomail."
  }'

The email is sent immediately via Amazon SES. The response includes the message ID and status.

5. Check your inbox

Poll for inbound messages, or set up a webhook to receive them in real time.

curl
curl https://api.robotomail.com/v1/mailboxes/MAILBOX_ID/messages?direction=INBOUND \
  -H "Authorization: Bearer $ROBOTOMAIL_API_KEY"

Next steps