# Create a user

**POST /v1/users**

Creates a new user.


## Servers
- https://api.sensay.io: https://api.sensay.io ()


## Authentication methods
- Organization service token


## Parameters
### Headers
- **X-API-Version** (string)




### Body: application/json (object)

- **email** (string(email))
  The email address
- **id** (string)
  The ID of the user
- **linkedAccounts** (array[object])
  The linked accounts of the user
- **name** (string)
  The name of the user (max 50 chars, letters/numbers/spaces and ( ) . , ' - /)


## Responses
### 200
The created User entity

#### Body: application/json (object)
- **email** (string(email))
  The email address
- **id** (string)
  The ID of the user
- **linkedAccounts** (array[object])
  The linked accounts of the user
- **name** (string)
  The name of the user
- **success** (boolean)
  Indicates the request was successful

### 409
User, email, or linked account already exists

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting


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