Create/Update Patient

Use the PatientCareIntegration_registerFollowupPatient method to register a patient in a Patient Care follow-up flow.

This method lets you register the patient and associate them with the follow-up configured in the program.

---

Step 1: Get the Authentication Token and Headers

Before performing any operation, you must authenticate and obtain a valid token.

This endpoint uses the Patient Care authentication flow.

For more details, see: Patient Care Authentication

---

Step 2: Create/Update Patient

Use the PatientCareIntegration_registerFollowupPatient method to register a patient in the desired follow-up flow.

Parameters

Parameter	Type	Required	Description	Value
followupSlug	String	Yes	Follow-up identifier	Possible values - followupSlug
input	Object	Yes	Patient and caregiver data	Object

---

Possible values - followupSlug

Value	Description
SAC_TEVA	Teva SAC service flow
Esclerose_multipla	Multiple sclerosis follow-up program
enxaqueca	Migraine follow-up program
huntington_ou_discinesia	Huntington's disease or dyskinesia follow-up program
diagnostico_huntington	Huntington's disease diagnosis flow

---

Input Fields

Field	Type	Required	Description
name	String	Yes	Patient name
country	Int	Yes	Country code. Possible values - country
cpf	String	Yes	Patient CPF
email	String	No	Patient email
acceptProgramTerms	Boolean	Yes	Acceptance of the program terms
recipientType	String	Yes	Recipient type. Possible values - recipientType
phone	String	No	Main phone number
caregiverCpf	String	No	Caregiver CPF
caregiverName	String	No	Caregiver name
caregiverKinship	Int	No	Kinship degree. Possible values - caregiverKinship
city	String	No	City
state	String	No	State
doctorCrm	String	No	Doctor CRM
doctorUf	String	No	CRM state
doctorName	String	No	Doctor name

---

Possible values - recipientType

Value	Description
PATIENT	Patient
CLINIC	Clinic

---

Possible values - country

Value	Country
0	Brazil
1	Peru
2	Mexico

---

Possible values - caregiverKinship

Value	Description
0	Father
1	Mother
2	Sibling
3	Child
4	Uncle/Aunt
5	Friend
6	Other
7	Relative
8	Healthcare professional
9	Husband
10	Wife

---

GraphQL Mutation Example

mutation registerFollowupPatient {
  PatientCareIntegration_registerFollowupPatient(
    followupSlug: "programa_acompanhamento"
    input: {
      name: "JOAO DA SILVA"
      country: 0
      cpf: "12345678900"
      email: "joao.silva@email.com"
      acceptProgramTerms: true
      recipientType: "PATIENT"
      phone: "11999999999"
      caregiverCpf: "98765432100"
      caregiverName: "MARIA DA SILVA"
      caregiverKinship: 1
      city: "São Paulo"
      state: "SP"
      doctorCrm: "123456"
      doctorUf: "SP"
      doctorName: "DRA ANA TESTE"
    }
  ) {
    id
    idPatient
    followup
    numberRegisterPatient
    isNew
  }
}

---

Return Example

{
  "data": {
    "PatientCareIntegration_registerFollowupPatient": {
      "id": "8c7d6f11-52b1-4eab-9a32-2d4f1a7c6b90",
      "idPatient": "3f4a9b21-9d3f-45c8-b11d-8a1e6d2f7c44",
      "followup": "programa_acompanhamento",
      "numberRegisterPatient": 100245,
      "isNew": true
    }
  }
}

---

Notes

• The followupSlug field identifies the follow-up flow configured in Patient Care.
• The recipientType field must follow the valid values defined by the integration.
• The country and caregiverKinship fields use numeric values according to the platform's internal enums.
• The method may create a new patient or reuse an existing registration, according to the platform's internal validations.