Crear un usuario del centro de ayuda

Crea un usuario del centro de ayuda cuyos atributos guardados son aquellos con los que coinciden las reglas de audiencia de los grupos de usuarios.

POST /v1/users

Token Bearer ámbito content:write

curl 'https://api.ferndesk.com/v1/users' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "[email protected]",
  "name": "Alice Example",
  "attributes": {
    "plan": "enterprise"
  },
  "disabled": false
}'

{
  "id": "hcusr_01JXYB3S2Y8C",
  "helpdeskId": "help_01JXYA7B3T7G",
  "email": "[email protected]",
  "name": "Alice Example",
  "emailVerified": true,
  "disabled": false,
  "attributes": {
    "plan": "enterprise",
    "role": "admin",
    "beta": true,
    "seats": 25,
    "groups": [
      "beta",
      "internal"
    ],
    "availableFrameworks.csrd": true
  },
  "lastLoginAt": "2026-01-15T18:25:43.511Z",
  "createdAt": "2026-01-15T18:25:43.511Z",
  "updatedAt": "2026-01-15T18:25:43.511Z"
}

Usuario del centro de ayuda creado

Cuerpo

obligatorio application/json

email string · email · patrón obligatorio

Dirección de correo electrónico, almacenada en minúsculas.

name string | null

Nombre para mostrar.

attributes object

Atributos que se guardarán para la coincidencia con grupos de usuarios.

disabled boolean · por defecto: false

Crea el usuario sin capacidad para mantener una sesión.

Cuerpo

Respuestas