---
title: "/people"
method: POST
path: "/people"
tags: ["Patient Management"]
---

# /people

`POST /people`

1. **first_name:** Nombre del paciente, obligatorio
    
2. **last_name:** Apellido del paciente, obligatorio
    
3. **born_at**: Utilizar el formato "aaa-mm-dd"
    
4. **gender**: puedes utilizar los valores "f", "m" u "o" (f= fenemino, m=masculino y o= Otro)
    
5. **telephone2**: Celular del paciente
    
    1. Los dígitos deben coincidir con el código del país agregado en **phone_country_id.**
        
    2. El campo es obligatorio u opcional, está condicionado al campo "without_cellphone":
        
        1. without_cellphone = false, entonces telephone2; obligatorio
            
        2. without_cellphone = true, entonces telephone2; opcional
            
6. **email**: Campo obligatorio u opcional, condicionado al campo "send_welcome_email"
    
    1. send_welcome_email= true, por lo tanto email: obligatorio
        
    2. send_welcome_email= false, por lo tanto email: opcional
        
7. **notes**: Opcional, puede ir vacío. Notas medicas del paciente
    
8. **send_welcome_email:** Valores "true" o "false". Define si el campo email es obligatorio
    
9. **Person attributes**
    
    1. "send_reminders": Valores "true" o "false". Define si el paciente acepta recibir notificaciones por whatsApp
        
    2. "identity_number": Opcional, curp del paciente
        
10. **without_cellphone**: Obligatorio, valores: "true" o "false". Define si el campo email es obligatorio
    
11. **patient_group_ids**: Opcional, arreglo con el id de los grupos al que el paciente pertenece. Se obtiene del catálogo de grupos de pacientes.  
    (Catalogo mencionado en prerequisistos)
    
12. **account_id**: ID del médico tratante, obtenido del catálogo de médicos. Define si el campo email es obligatorio (Catalogo mencionado en prerrequisistos)
    
13. **address_state_id**: ID del estado de la dirección del paciente, obtenido del catálogo de estados (Catalogo mencionado en prerrequisistos)
    
14. **phone_country_id**: Código del país al que pertenece el numero celular agregado en el campo **phone_country_id** (Ejemplo para agregar número de México: "142")

## Request body

- object
  - `person` object
    - `first_name` string
    - `last_name` string
    - `born_at` string
    - `gender` string
    - `phone_country_id` string
    - `telephone2` string
    - `email` string
    - `account_id` string

## Response `201`

/people

- object
  - `person` object
    - `id` integer
    - `first_name` string
    - `last_name` string
    - `links` object
      - `consultations` string
      - `consultation_lab_test_results` string
      - `consultation_schedules` string
      - `vital_signs_sets` string
      - `medical_history` string
      - `deffers` string
      - `medical_notes` string
      - `insurance_coverage` string
    - `full_name` string
    - `telephone` unknown
    - `email` unknown
    - `born_at` string, date
    - `gender` string
    - `avatar_url_small` string
    - `avatar_url_medium` string
    - `telephone2` string, utc-millisec
    - `address_state_id` integer
    - `address_city` unknown
    - `address_street` unknown
    - `address_zipcode` unknown
    - `identity_number` unknown
    - `account_id` integer
    - `avatar_url_large` string
    - `notes` unknown
    - `person_attributes` object
    - `phone_country_id` integer
    - `is_migrated` boolean
    - `without_cellphone` boolean
    - `nimbochat_invitation_sent` boolean
    - `medical_record` unknown

---

[API](https://skmtc.net/ecaresoft/apis/nimbo-api.md) · [All operations](https://skmtc.net/ecaresoft/apis/nimbo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ecaresoft/nimbo-api/versions/f05c97f9a653/schema)