---
title: "Crear un usuario"
method: POST
path: "/users"
tags: ["Usuarios"]
---

# Crear un usuario

`POST /users`

## Request

- Base URL: `https://api.alegra.com/api/v1`
- URL: `https://api.alegra.com/api/v1/users`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Endpoint que permite crear un usuario en la cuenta de Alegra.

## Request body

- object
  - `username` string
  - `name` string
  - `lastName` string
  - `email` string
  - `phone` string
  - `phoneCode` string
  - `role` string
  - `language` string
  - `position` 'owner' | 'manager' | 'administrator' | 'administrative-assistant' | 'sales' | 'financial-manager' | 'financial-assistant' | 'accountant' | 'accountant-assistant' | 'other'

## Response `200`

Retorna información de un usuario

- object
  - `id` string: ID del usuario
  - `username` string, nullable: Nombre de usuario
  - `name` string: Nombre del usuario
  - `lastName` string: Apellido del usuario
  - `email` string, email: Correo electrónico del usuario
  - `phone` string: Teléfono del usuario
  - `phoneCode` string: Código de país del teléfono
  - `role` string: Rol del usuario
  - `status` 'active' | 'inactive': Estado del usuario
  - `language` string: Idioma del usuario
  - `position` string: Posición del usuario

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `403` (unresolved $ref)

---

[API](https://skmtc.dev/alegra/apis/configuraciones.md) - [All operations](https://skmtc.dev/alegra/apis/configuraciones/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/configuraciones/revisions/5a651ca3b942?raw)