---
title: "Invita a una persona al portal"
method: POST
path: "/partner/usuarios"
tags: ["partner"]
---

# Invita a una persona al portal

`POST /partner/usuarios`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/partner/usuarios`
- Auth: HTTP bearer

Nace sin contrasena utilizable y recibe un enlace para fijar la suya. Requiere rol admin.

## Request body

- object
  - `email` string, required
  - `nombre` string, required
  - `rol` 'admin' | 'lector'

## Response `201`

Invitada

- object
  - `id` string, uuid
  - `email` string
  - `nombre` string
  - `rol` 'admin' | 'lector'
  - `estado` 'activo' | 'suspendido'
  - `activo` boolean: false = invitacion pendiente (nunca fijo su contrasena)
  - `ultimoLoginAt` string, date-time, nullable
  - `createdAt` string, date-time

## Other responses

- `403`: Tu rol es de solo lectura
- `409`: Ese correo ya tiene acceso

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)