---
title: "Creating an user"
method: POST
path: "/users"
tags: ["Company Users"]
---

# Creating an user

`POST /users`

Creates a new company user.

## Request body

- CompanyUserPostRequest
  - `name` string, required — User name
  - `email` string, required — User email
  - `profileTestEnabled` boolean — Flag to set if tests are enabled
  - `accessProfileId` number — Id from access profile to be bound
  - `departmentId` number — Id from department to be bound
  - `roleId` number — Id from user role
  - `code` string — User identifier code
  - `taxpayerRegistry` string — User taxpayer registry
  - `countryOfOrigin` string — User origin country
  - `branchIds` number[] — Ids from branches to be bound

## Response `200`

The created user

- User — User
  - `id` integer, required — User ID
  - `name` string, required — User name
  - `email` string — User email
  - `departmentId` integer — Id from department from whose the user belongs
  - `roleId` integer — Id from role from whose the user belongs
  - `profileTestEnabled` boolean — Checks if user must make profile tests
  - `type` 'root' | 'owner' | 'guest' — Kind of user
  - `code` string, required — User identifier
  - `taxpayerRegistry` string — User taxpayer registry
  - `countryOfOrigin` string — User origin country
  - `accessProfileId` number — Id from access profile
  - `branchIds` integer[] — List of company branches IDs associated to the user
  - `createdAt` string, date-time, required — Data of creation
  - `updatedAt` string, date-time, required — Date of update

## Other responses

- `400` — BadRequest / Invalid Input
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/gupy/apis/gupy-public-api.md) · [All operations](https://skmtc.net/gupy/apis/gupy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupy/gupy-public-api/versions/3f26defa2a42/schema)