2026-08-11 11:22:55 -04:00
---
# Code generated by make gen. DO NOT EDIT.
2026-09-28 15:44:10 -04:00
title : "`coder users create`"
2026-08-11 11:22:55 -04:00
description : Create a new user.
---
2023-03-23 17:42:20 -05:00
<!-- DO NOT EDIT | GENERATED CONTENT -->
2025-05-13 16:48:16 -04:00
Create a new user.
2023-03-23 17:42:20 -05:00
## Usage
```console
coder users create [flags]
```
## Options
### -e, --email
2026-10-21 10:58:04 -07:00
| Property | Value |
|----------|---------------------|
| Type | <code>string</code> |
2023-03-23 17:42:20 -05:00
Specifies an email address for the new user.
2024-03-15 11:24:38 -05:00
### -u, --username
2023-08-10 20:04:35 -05:00
2026-10-21 10:58:04 -07:00
| Property | Value |
|----------|---------------------|
| Type | <code>string</code> |
2023-08-10 20:04:35 -05:00
2024-03-15 11:24:38 -05:00
Specifies a username for the new user.
2023-08-10 20:04:35 -05:00
2024-06-26 09:00:42 +01:00
### -n, --full-name
2026-10-21 10:58:04 -07:00
| Property | Value |
|----------|---------------------|
| Type | <code>string</code> |
2024-06-26 09:00:42 +01:00
Specifies an optional human-readable name for the new user.
2023-03-23 17:42:20 -05:00
### -p, --password
2026-10-21 10:58:04 -07:00
| Property | Value |
|----------|---------------------|
| Type | <code>string</code> |
2023-03-23 17:42:20 -05:00
Specifies a password for the new user.
2024-03-15 11:24:38 -05:00
### --login-type
2023-03-23 17:42:20 -05:00
2026-10-21 10:58:04 -07:00
| Property | Value |
|----------|---------------------|
| Type | <code>string</code> |
2023-03-23 17:42:20 -05:00
2026-04-27 15:51:01 -07:00
Optionally specify the login type for the user. Valid values are: password, none, github, oidc. Using 'none' prevents the user from authenticating and requires an API key/token to be generated by an admin. Deprecated: 'none' is deprecated. Use service accounts (requires Premium) for machine-to-machine access, or password/github/oidc login types for regular user accounts.
2024-07-01 11:04:45 -10:00
2026-03-17 14:07:20 -08:00
### --service-account
2026-10-21 10:58:04 -07:00
| Property | Value |
|----------|-------------------|
| Type | <code>bool</code> |
2026-03-17 14:07:20 -08:00
Create a user account intended to be used by a service or as an intermediary rather than by a human.
2024-07-01 11:04:45 -10:00
### -O, --org
2026-10-21 10:58:04 -07:00
| Property | Value |
2025-01-03 18:12:59 +05:00
|-------------|----------------------------------|
2024-07-01 11:04:45 -10:00
| Type | <code>string</code> |
| Environment | <code>$CODER_ORGANIZATION</code> |
Select which organization (uuid or name) to use.