Create a New Agent Organization

This endpoint is for signing up for the first time. If you’ve already signed up, you’re all set — just use your existing API key.

A 6-digit OTP is sent to the human’s email for verification.

This endpoint is idempotent. Calling it again with the same human_email will rotate the API key and resend the OTP if expired.

The returned API key has limited permissions until the organization is verified via the verify endpoint.

agentmail agent sign-up --human-email user@example.com --username my-agent

This endpoint expects an object.

human_email string Required
Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
username string Required
Username for the auto-created inbox (e.g. “my-agent” creates my-agent@agentmail.to).

This endpoint returns an object.

organization_id string
ID of the created organization.
inbox_id string
ID of the auto-created inbox.
api_key string
API key for authenticating subsequent requests. Store this securely, it cannot be retrieved again.