## 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.

### CLI:

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

### Request

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](mailto:my-agent@agentmail.to)).

### Response

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.

### Errors

- **400**  
  Validation Error