Your agents
need an inbox

robotomail send \
  --from myagent@robotomail.co \
  --to user@example.com \
  --subject "Your report is ready" \
  --body "Hi — here's the Q1 report."

# ✓ Email sent!
#   Message ID  <b2c3d4e5-6789-4abc-def0-222222222222@robotomail.co>

robotomail messages myagent@robotomail.co --direction INBOUND

# ID        Direction  From             Subject                     Status
# b2c3d4e5  INBOUND    jane@acme.com    Re: Your report is ready   RECEIVED
# f6g7h8i9  INBOUND    ops@stripe.com   Invoice #4821              RECEIVED
# j1k2l3m4  INBOUND    team@linear.app  Issue assigned to you      RECEIVED

curl -X POST https://api.robotomail.com/v1/mailboxes/MAILBOX_ID/messages \
  -H "Authorization: Bearer rm_a1b2c3..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["user@example.com"],
    "subject": "Your report is ready",
    "bodyText": "Hi — here's the Q1 report."
  }'

# → {
#   "message": {
#     "id": "b2c3d4e5-6789-4abc-def0-222222222222",
#     "status": "SENT",
#     "fromAddress": "myagent@robotomail.co",
#     "threadId": "c3d4e5f6-789a-4bcd-ef01-333333333333"
#   }
# }

import requests

resp = requests.post(
    "https://api.robotomail.com/v1/mailboxes/MAILBOX_ID/messages",
    headers={"Authorization": "Bearer rm_a1b2c3..."},
    json={
        "to": ["user@example.com"],
        "subject": "Your report is ready",
        "bodyText": "Hi — here's the Q1 report.",
    },
)

message = resp.json()["message"]
# → message["id"], message["status"],
#   message["fromAddress"], message["threadId"]

const resp = await fetch(
  "https://api.robotomail.com/v1/mailboxes/MAILBOX_ID/messages",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer rm_a1b2c3...",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      to: ["user@example.com"],
      subject: "Your report is ready",
      bodyText: "Hi — here's the Q1 report.",
    }),
  }
);

const { message } = await resp.json();
// → message.id, message.status, message.threadId