---
title: "Update patient"
method: PATCH
path: "/patients/{id}"
tags: ["Patient"]
---

# Update patient

`PATCH /patients/{id}`

## Path parameters

- `id` string, int64, required

## Request body

- object
  - `accepted_email_marketing` boolean, nullable
  - `accepted_privacy_policy` boolean, nullable
  - `address_1` string, nullable
  - `address_2` string, nullable
  - `address_3` string, nullable
  - `appointment_notes` string, nullable
  - `city` string, nullable
  - `concession_type_id` string, int64 — concession type id
  - `country` string, nullable
  - `country_code` string, nullable — [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes) country code
  - `custom_fields` object, nullable
    - `sections` object[]
      - `name` string, nullable
      - `token` string, uuid, required
      - `archived` boolean, nullable
      - `fields` union[], required
        - union
          - PatientCustomFieldText
            - `value` string
            - `archived` boolean, nullable
            - `name` string, nullable
            - `token` string, uuid, required
            - `type` 'text', nullable
          - PatientCustomFieldParagraph
            - `value` string
            - `archived` boolean, nullable
            - `name` string, nullable
            - `token` string, uuid, required
            - `type` 'paragraph', nullable
          - PatientCustomFieldDate
            - `value` string, date
            - `archived` boolean, nullable
            - `name` string, nullable
            - `token` string, uuid, required
            - `type` 'date', nullable
          - PatientCustomFieldCheckboxes
            - `options` object[]
              - …
            - `other` object
              - …
            - `archived` boolean, nullable
            - `name` string, nullable
            - `token` string, uuid, required
            - `type` 'checkboxes', nullable
          - PatientCustomFieldRadiobuttons
            - `options` object[]
              - …
            - `other` object
              - …
            - `archived` boolean, nullable
            - `name` string, nullable
            - `token` string, uuid, required
            - `type` 'radiobuttons', nullable
  - `date_of_birth` string, date, nullable
  - `dva_card_number` string, nullable
  - `email` string, nullable
  - `emergency_contact` string, nullable
  - `first_name` string
  - `gender_identity` string, nullable
  - `invoice_default_to` string, nullable
  - `invoice_email` string, nullable
  - `invoice_extra_information` string, nullable
  - `last_name` string
  - `medicare_reference_number` string, nullable
  - `medicare` string, nullable
  - `notes` string, nullable
  - `occupation` string, nullable
  - `old_reference_id` string, nullable
  - `post_code` string, nullable
  - `preferred_first_name` string, nullable
  - `pronouns` object, nullable
    - `accusative` string, required
    - `nominative` string, required
    - `predicative_possessive` string, required
    - `pronominal_possessive` string, required
    - `reflexive` string, required
  - `receives_cancellation_emails` boolean, nullable
  - `receives_confirmation_emails` boolean
  - `referral_source` string, nullable
  - `referring_doctor_id` string, int64 — contact id
  - `reminder_type` 'None' | 'SMS' | 'Email' | 'SMS & Email', nullable — Please use the `reminders_communication_channels` attribute instead.
  - `sex` string, nullable
  - `state` string, nullable
  - `time_zone` string, nullable — See: [supported time zone identifiers](/guides/time_zone_support/#accepted-values-for-time_zone_identifier)
  - `title` string, nullable
  - `unsubscribe_sms_marketing` boolean
  - `follow_ups_communication_channels` integer[] — The array of communication channels that will be used for this patient's follow-up messages. | Enum Value | Description | |---|---| | 1 | SMS | | 2 | Email |
  - `reminders_communication_channels` integer[] — The array of communication channels that will be used for this patient's reminders. | Enum Value | Description | |---|---| | 1 | SMS | | 2 | Email |
  - `patient_phone_numbers` object[]
    - `number` string, phone
    - `phone_type` 'Fax' | 'Home' | 'Mobile' | 'Other' | 'Work'

## Response `200`

Resource was updated

- Patient
  - `accepted_email_marketing` boolean, nullable
  - `accepted_privacy_policy` boolean, nullable
  - `accepted_sms_marketing` boolean, nullable
  - `address_1` string, nullable
  - `address_2` string, nullable
  - `address_3` string, nullable
  - `appointment_notes` string, nullable
  - `appointments` object
    - `links` object
      - `self` string, uri
  - `archived_at` string, date-time, nullable
  - `attendees` object
    - `links` object
      - `self` string, uri
  - `city` string, nullable
  - `concession_type` object
    - `links` object
      - `self` string, uri
  - `country` string, nullable
  - `country_code` string, nullable — [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes) country code
  - `created_at` string, date-time
  - `custom_fields` object, nullable
    - `sections` object[]
      - `name` string, nullable
      - `token` string, uuid, required
      - `archived` boolean, nullable
      - `fields` union[], required
        - union
          - PatientCustomFieldText
            - `value` string
            - `archived` boolean, nullable
            - `name` string, nullable
            - `token` string, uuid, required
            - `type` 'text', nullable
          - PatientCustomFieldParagraph
            - `value` string
            - `archived` boolean, nullable
            - `name` string, nullable
            - `token` string, uuid, required
            - `type` 'paragraph', nullable
          - PatientCustomFieldDate
            - `value` string, date
            - `archived` boolean, nullable
            - `name` string, nullable
            - `token` string, uuid, required
            - `type` 'date', nullable
          - PatientCustomFieldCheckboxes
            - `options` object[]
              - …
            - `other` object
              - …
            - `archived` boolean, nullable
            - `name` string, nullable
            - `token` string, uuid, required
            - `type` 'checkboxes', nullable
          - PatientCustomFieldRadiobuttons
            - `options` object[]
              - …
            - `other` object
              - …
            - `archived` boolean, nullable
            - `name` string, nullable
            - `token` string, uuid, required
            - `type` 'radiobuttons', nullable
  - `date_of_birth` string, date, nullable
  - `deleted_at` string, date-time, nullable
  - `dva_card_number` string, nullable
  - `email` string, nullable
  - `emergency_contact` string, nullable
  - `first_name` string
  - `follow_ups_communication_channels` integer[] — Channels through which the patient will receive appointment follow-up messages. | Enum Value | Description | |---|---| | 1 | SMS | | 2 | Email |
  - `follow_ups_communication_channels_description` 'None' | 'SMS' | 'Email' | 'SMS & Email'
  - `gender` string, nullable
  - `gender_identity` string, nullable
  - `id` string, int64
  - `invoice_default_to` string, nullable
  - `invoice_email` string, nullable
  - `invoice_extra_information` string, nullable
  - `invoices` object
    - `links` object
      - `self` string, uri
  - `label` string, nullable — Full name
  - `last_name` string
  - `latest_booking` object
    - `links` object
      - `self` string, uri
  - `links` object
    - `self` string, uri
  - `medical_alerts` object
    - `links` object
      - `self` string, uri
  - `medicare` string, nullable
  - `medicare_reference_number` string, nullable
  - `merged_at` string, date-time, nullable
  - `merged_with_patient` object
    - `links` object
      - `self` string, uri
  - `notes` string, nullable
  - `occupation` string, nullable
  - `old_reference_id` string, nullable
  - `patient_attachments` object
    - `links` object
      - `self` string, uri
  - `patient_phone_numbers` PhoneNumber[], nullable
    - `normalized_number` string, phone
    - `number` string, phone
    - `phone_type` 'Fax' | 'Home' | 'Mobile' | 'Other' | 'Work'
  - `post_code` string, nullable
  - `preferred_first_name` string, nullable
  - `pronouns` object, nullable
    - `accusative` string, required
    - `nominative` string, required
    - `predicative_possessive` string, required
    - `pronominal_possessive` string, required
    - `reflexive` string, required
  - `receives_cancellation_emails` boolean, nullable
  - `receives_confirmation_emails` boolean
  - `referral_source` string, nullable
  - `referring_doctor` object
    - `links` object
      - `self` string, uri
  - `relationships` object
    - `links` object
      - `self` string, uri
  - `reminder_type` 'None' | 'SMS' | 'Email' | 'SMS & Email', nullable — Please use the `reminders_communication_channels` attribute instead.
  - `reminders_communication_channels` integer[] — Channels through which the patient will receive appointment reminders. | Enum Value | Description | |---|---| | 1 | SMS | | 2 | Email |
  - `reminders_communication_channels_description` 'None' | 'SMS' | 'Email' | 'SMS & Email'
  - `sex` string, nullable
  - `state` string, nullable
  - `time_zone` string, nullable — See: [supported time zone identifiers](/guides/time_zone_support/#accepted-values-for-time_zone_identifier)
  - `title` string, nullable
  - `updated_at` string, date-time

## Other responses

- `422` — Resource could not be saved due to validation errors

---

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