Signup

Create a new Robotomail account and receive an API key.

POST /v1/signup

POST/v1/signup

Public endpoint — no authentication required.

Request body

Name	Type	Description
email*	string	Valid email address
password*	string	Minimum 8 characters
slug*	string	3-30 chars, lowercase alphanumeric + hyphens. Becomes your subdomain.
name	string	Display name. Defaults to email prefix.

response — 201 Created

{
  "user": {
    "id": "usr_abc123",
    "email": "[email protected]",
    "slug": "myagent",
    "plan": "free",
    "platform_domain": "myagent.robotomail.com"
  },
  "api_key": {
    "key": "rm_a1b2c3d4e5...",
    "prefix": "rm_a1b2c",
    "name": "default"
  },
  "mailbox_limit": 1,
  "daily_send_limit": 50,
  "email_verified": false
}

Errors

400 — Invalid input (email format, password too short, slug format)
409 — Email or slug already registered
429 — Rate limited (5 signups per hour per IP)