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

# Crear Usuario

`POST /users`

## Headers

- `campusID` string, uuid, required
- `periodID` string, uuid, required — ID del periodo que se desea trabajar.

## Request body

- UserCreate
  - `name` string, required — Nombre(s) de la persona, estudiante o usuario.
  - `first_last_name` string, required — Apellido paterno de la persona, sea un estudiante o usuario.
  - `second_last_name` string — Apellido materno de la persona, estudiante o usuario.
  - `email` string, required — Correo Electronico para el envio de facturas electronicas.
  - `tin` string, required — Números de Identificación fiscal.
  - `document_type` 'CURP' | 'CI' | 'RUC' | 'NIT' | 'PASSPORT' | 'CC' | 'CE' | 'NIP' | 'TI' | 'PPT' — Tipo de documento según el país - México(CURP, PASSPORT), Colombia(PASSPORT, CC, CE, NIT, TI, NIP, PPT), Ecuador(PASSPORT, RUC, CI).
  - `phone` string, required — Número de teléfono con codigo de pais del usuario.
  - `external_id` string, required — Campo arbitrario de datos de terceros
  - `metadata` object, required — Campo arbitrario de datos de terceros
  - `tax_data` union
    - object
      - `name` string, required — Nombre del responsable fiscal
      - `rfc` string, required — Número de identificación del responsable fiscal
      - `email` string, required — Email del responsable fiscal
      - `tax_regime` string, required — Valor el régimen fiscal del responsable
      - `cfdi_id` string, required — Comprobante fiscal digital
      - `zip_code` string, required — Código postal del responsable fiscal
      - `street` string — Dirección del responsable fiscal
      - `suburb` string — Este campo indica la colonia o barrio específico dentro de la ciudad donde se encuentra la dirección.
      - `city` string — Nombre de la ciudad del responsable fiscal
      - `state` string — Este campo indica el estado o entidad federativa en la que se encuentra la dirección.
      - `document_type` string — Este campo indica el tipo de documento
      - `department_code` string — Código del departamento de residencia
      - `municipality_code` string — Código de la ciudad o municipio
    - object
      - `name` string, required — Nombre del responsable fiscal
      - `rfc` string, required — Número de identificación del responsable fiscal
      - `email` string, required — Email del responsable fiscal
      - `tax_regime` string — Valor el régimen fiscal del responsable
      - `cfdi_id` string — Comprobante fiscal digital
      - `zip_code` string — Código postal del responsable fiscal
      - `street` string, required — Dirección del responsable fiscal
      - `suburb` string — Este campo indica la colonia o barrio específico dentro de la ciudad donde se encuentra la dirección.
      - `city` string, required — Nombre de la ciudad del responsable fiscal
      - `state` string, required — Este campo indica el estado o entidad federativa en la que se encuentra la dirección.
      - `document_type` string, required — Este campo indica el tipo de documento
      - `department_code` string, required — Código del departamento de residencia
      - `municipality_code` string, required — Código de la ciudad o municipio
    - object
      - `name` string, required — Nombre del responsable fiscal
      - `rfc` string, required — Número de identificación del responsable fiscal
      - `email` string, required — Email del responsable fiscal
      - `tax_regime` string — Valor el régimen fiscal del responsable
      - `cfdi_id` string — Comprobante fiscal digital
      - `zip_code` string — Código postal del responsable fiscal
      - `street` string, required — Dirección del responsable fiscal
      - `suburb` string — Este campo indica la colonia o barrio específico dentro de la ciudad donde se encuentra la dirección.
      - `city` string, required — Nombre de la ciudad del responsable fiscal
      - `state` string, required — Este campo indica el estado o entidad federativa en la que se encuentra la dirección.
      - `document_type` string, required — Este campo indica el tipo de documento
      - `department_code` string — Código del departamento de residencia
      - `municipality_code` string — Código de la ciudad o municipio

## Response `201`

Crear Usuario

- User[]
  - `id` string, uuid — Identificador único del registro
  - `created_at` string, date-time — Fecha y hora de creacion del registro
  - `updated_at` string, date-time — Fecha y hora de creacion del registro

## Other responses

- `404` — unresolved $ref

---

[API](https://skmtc.net/mattilda-education/apis/mattilda-api.md) · [All operations](https://skmtc.net/mattilda-education/apis/mattilda-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mattilda-education/mattilda-api/revisions/a7093ab951dc/schema)