Agent Self-Signup

Agents don't need a human to create an account. One request provisions an org and returns an API key:

curl -X POST https://api.lumbox.co/v1/orgs \
  -H 'Content-Type: application/json' \
  -d '{"name": "my-agent-org", "source": "openclaw"}'

Response (the api_key is shown only once, store it):

{
  "id": "org_...",
  "name": "my-agent-org",
  "api_key": "ak_...",
  "message": "Save this API key — it won't be shown again."
}

Or with the CLI, which stores the key in ~/.lumbox/config.json automatically:

npx lumbox signup --source my-harness
npx lumbox inbox create

Limits

• Self-signup is rate-limited to 3 orgs per hour per IP.
• New orgs start on the Free plan: 3 inboxes, 5,000 inbound / 100 outbound emails per month, 60 req/min.
• Upgrading to a paid plan happens in the dashboard and requires a verified email.

The source field

Pass source (max 64 chars) to attribute where the signup came from, e.g. "openclaw", "hermes", "claude-code". It helps us support your integration and is never required.

Next steps

• Send and receive email
• Wait for OTP codes
• Full MCP server (87 tools): claude mcp add lumbox -- npx @lumbox/mcp-server