1. Users
PHOQO
  • Guía: Crear empresa, clínica y asignar plan
  • V1
    • Documentos
      • Listar documentos
      • Cargar un documentos
    • Companies
      • Patients
        • Obtener informacion de 1 paciente
        • Buscar pacientes en la empresa
        • Cargar un paciente en una empresa
      • Clinics
        • _id
          • Actualizar un clinica en una empresa
          • Parchar clinica en una empresa
        • Cargar un clinica en una empresa
        • Listar un clinicas en una empresa
      • Setting
        • Cargar una Configuracion
      • Cargar una empresa
      • Editar una empresa
      • Parchar una empresa
    • Users
      • _ID
        • Roles
          • Obtener Roles de un usuario (v1 - deprecado)
        • Get User
        • Actualizar campo en ususario
      • Crear usuario en una empresa
        POST
      • Listar usuarios de una empresa
        GET
    • Tools
      • Files
        • Multipart
          • 1. Obtener urls para subir un archivo
          • 3. Confirmar Carga de archivo por multipart
        • Simple
          • 1. Obtener url para cargar archivo
        • Obtener una url pre firmada para poder visualizar un archivo segun su key
  • V2
    • Settings
      • Company
      • Asignar roles a un usuario
      • Listar roles de un usuario
      • Remover un rol de un usuario
      • Listar roles
      • Asignar plan a empresa
      • Document
    • Patients
      • Buscar pacientes
      • Crear pacientes
    • Tools
      • Files
        • Analysis
          • Analizar archivo con IA
          • Consultar un análisis
          • Consultar análisis de un archivo
          • URL para ver un análisis
          • Permite obtener el reporte PDF de un analisis
        • Multipart
          • Cargar archivo Multipart
          • Completar Carga
          • Cancelar Carga
          • Consultar estado de Carga
        • Cargar archivo desde un origen
    • Documents
      • Exams
        • Buscar Examenes
      • Orders
        • Buscar Ordenes
    • Companies
      • Crear empresa
      • Crear clínica en empresa
  • Schemas
    • Base Response
    • Base Response Error
    • Paciente
    • Tipo de identificacion
    • Usuario
    • Status
    • Clinica
    • User In Request
    • Codigos Examen
    • Document Status
    • BaseSearchRequest
    • Patient
    • File
    • File Group
    • Date
    • Examen
    • Usuario Info
    • Orden
    • IA PROVIDER
    • Scan Types
    • Company Services
  1. Users

Crear usuario en una empresa

POST
https://api-pruebas.phoqo.cl/pruebas/v1/companies/{company_id}/users
Agrega (invita) un usuario interno a una empresa y lo asocia a sus clínicas y exámenes habilitados.
Comportamiento:
Valida que no exista ya un usuario activo con el mismo username en la empresa. Si existe, responde 400 con User already exist in company.
Si el username no existe en el sistema, crea el usuario global (type=internal) y emite evento de integración. Si ya existe, reutiliza su userId.
Crea/actualiza la información personal del usuario (UserInfo).
Crea la relación usuario-empresa (UserCompany) con estado active si no existía, y emite evento de invitación.
Reemplaza las asociaciones de clínicas del usuario en esta empresa por las indicadas en clinics.
Reemplaza los exámenes habilitados del usuario en esta empresa por los indicados en exams.
Escribe un registro en la bitácora.
Seguridad: requiere permiso company.users.create (scope company/users/create). Persiste en MySQL y DynamoDB.
Nota: el campo username es la llave de unicidad (se normaliza a minúsculas).

Solicitud

Autorización
Agregar parámetro en header
Authorization
Ejemplo:
Authorization: ********************
Parámetros de ruta

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Cargar una empresa
application/json
Bodyapplication/json

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://api-pruebas.phoqo.cl/pruebas/v1/companies/d6baef78-d4f0-457a-a119-7ebbbd4cdee8/users' \
--header 'empresa: ' \
--header 'grupo: ' \
--header 'x-application: PHOQO' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "username": "string",
    "identificationNumber": "string",
    "identificationType": "string",
    "name": "string",
    "middleName": "string",
    "lastName": "string",
    "motherLastName": "string",
    "email": "string",
    "phone": "string",
    "phoneCode": "string",
    "gender": "undefined",
    "nationality": "string",
    "birthDate": "string",
    "avatar": "string",
    "signature": "string",
    "status": "active",
    "type": "internal",
    "temporaryPassword": "string",
    "clinics": [
        "string"
    ],
    "exams": [
        "string"
    ]
}'
Respuesta Ejemplo de Respuesta
{
    "company": {
        "identificationNumber": "18331089-5",
        "businessName": "Claudio Miranda",
        "status": 1,
        "id": "6a0bb063-587b-4d24-960d-31030db1255f",
        "createAt": "2022-03-29 15:47:16.302664",
        "trackingId": "cb25770b-e86b-4b05-8b65-693e01e2b35b"
    },
    "codigo": 10,
    "mensaje": "Acción realizada satisfactoriamente",
    "fecha": "2022-03-29 12:47:16",
    "seguimientoId": "cb25770b-e86b-4b05-8b65-693e01e2b35b",
    "duracion": 405
}
Modificado en 2026-09-10 13:57:15
Anterior
Actualizar campo en ususario
Siguiente
Listar usuarios de una empresa
Built with