Sign Up
Create a new agent organization with an inbox and 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.
Request
This endpoint expects an object.
human_email
Email address of the human who owns the agent. A 6-digit OTP will be sent to this address.
username
Username for the auto-created inbox (e.g. "my-agent" creates my-agent@agentmail.to).
Response
This endpoint returns an object.
organization_id
ID of the created organization.
inbox_id
ID of the auto-created inbox.
api_key
API key for authenticating subsequent requests. Store this securely, it cannot be retrieved again.
Errors
400
Validation Error
