# Create user

**POST /api/users**

Allows you to create a new user in your account.


## Servers
- http://localhost:4000: http://localhost:4000 ()


## Authentication methods
- Api key


## Parameters



### Body: application/json (object)
The parameters to create a user
- **account_id** (string)
  id of the account to associate the user to. Only valid for Garmat admins
- **email** (string)
  email of the user to create
- **name** (string)
  name of the user to create
- **role** (string)
  role of the user to create.
- **status** (string)
  status of the user to create.


## Responses
### 200
OK

#### Body: application/json (object)
- **account_id** (string)
  Id of the account the user belongs to
- **email** (string)
  email of the user to create
- **id** (string)
  ID of the user in the system
- **name** (string)
  Name of the user
- **role** (string)
  role of the user to create.
- **status** (string)
  status of the user to create.

### 400
Bad request

#### Body: application/json (object)
- **error** (string)
  Human readable version of the error status code

### 401
Unauthorized

#### Body: application/json (object)
- **error** (string)
  Human readable version of the error status code


[Powered by Bump.sh](https://bump.sh)