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
npx lumbox claim

Agent-created organizations have no human owner. Run npx lumbox claim later with the saved full organization API key to get a one-time dashboard link. The link expires after 15 minutes and can be used once. Open it, sign in or create an account, and confirm the organization before continuing to billing. Restricted API keys cannot create claim links. An account that already owns an organization cannot claim another one.

Limits

• Self-signup is rate-limited to 3 orgs per hour per IP.
• New orgs start on the Free plan: 3 inboxes, 500 inbound / 100 outbound emails per month, 60 req/min.
• Upgrading to a paid plan happens in the dashboard. Email verification is not required by the current dashboard authentication configuration.

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: claude mcp add --transport http lumbox https://mcp.lumbox.co/mcp