Send your first email

A complete walkthrough from account creation to sending and verifying delivery.

1. Create your account

If you haven't already, sign up for a Robotomail account. See the Quickstart for the full signup flow.

shell

export ROBOTOMAIL_API_KEY="rm_your_key_here"

2. Create a mailbox

curl

curl -X POST https://api.robotomail.com/v1/mailboxes \
  -H "Authorization: Bearer $ROBOTOMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "address": "assistant", "displayName": "My AI Assistant" }'

3. Send an email

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 Robotomail",
    "bodyText": "This is my first email sent via the Robotomail API.",
    "bodyHtml": "<h1>Hello!</h1><p>This is my first email sent via the Robotomail API.</p>"
  }'

The response will have status: "SENT" — the email has been accepted by SES for delivery.

4. Verify delivery

Set up a webhook to receive message.delivered events, or poll the message to check its status:

curl

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

The status field will progress from SENT to DELIVERED once the recipient's mail server accepts the message.