---
title: "Edit a patient"
method: PATCH
path: "/practices/{practice_id}/patients/{patients}"
tags: ["patients"]
---

# Edit a patient

`PATCH /practices/{practice_id}/patients/{patients}`

## Request

- Base URL: `sandbox.collectly.co/api/api/partners/v1` (relative, and the document’s source URL is not known)
- URL: `sandbox.collectly.co/api/api/partners/v1/practices/{practice_id}/patients/{patients}`
- Auth: API key in header `Authorization`

Update a resource.

## Path parameters

- `practice_id` string, required
- `patients` string, required

## Request body

- Patient
  - `address` Address
    - `city` string, required
    - `country` string
    - `country_short` string
    - `line2` string, nullable
    - `name` string, nullable
    - `state` string, required
    - `status` string
    - `street` string, required
    - `street_number` string
    - `text` unknown
    - `zip_code` string, required
  - `card_auth_on_file` boolean: The flag indicates if the patient has at least one payment method that is authorized for auto-pay
  - `collectly_id` string: Unique Collectly resource ID
  - `created_at` unknown
  - `current_balance` number
  - `date_of_birth` string, date, nullable
  - `emails` Email[]
    - `additional_priorities` unknown
    - `all_priorities` unknown[]
      - unknown
    - `created_at` unknown
    - `email` string, email
    - `enabled` boolean
    - `id` integer
    - `priority` unknown
    - `source` string
  - `external_balance` number
  - `external_refnum` string, nullable
  - `first_name` string, required
  - `gender` string, nullable: Allowed values: female, male, other
  - `guarantor` Guarantor
    - `address` unknown
    - `collectly_id` string: Unique Collectly resource ID
    - `created_at` unknown
    - `data` unknown
    - `date_of_birth` string, date, nullable
    - `external_id` string, nullable
    - `first_name` string, required
    - `id` string, required: Unique resource ID from your integration
    - `last_name` string, required
    - `middle_name` string, nullable
    - `modified_at` unknown
    - `practice_id` string, required
    - `ssn` string, nullable
  - `id` string, required: Unique resource ID from your integration
  - `insurance_policies` InsurancePolicy1[]
    - `collectly_id` string: Unique Collectly resource ID
    - `id` string, nullable
    - `insurance_company_collectly_id` integer, required
    - `is_archived` boolean
    - `member_id` string, nullable
    - `name` string, nullable
    - `patient_collectly_id` integer
    - `priority` string
  - `last_billing_cycle` BillingCycle
    - `billing_rule_id` integer
    - `billing_rule_name` string
    - `last_notification_time` unknown
    - `last_notification_type` string
    - `paused_by_patient_reply` boolean
    - `status` unknown
  - `last_name` string, required
  - `last_payment_date` string, date-time: Date and time of the patient's last payment
  - `metadata` unknown
  - `middle_name` string, nullable
  - `modified_at` unknown
  - `on_payment_plan` boolean: The flag indicates if the patient has an active payment plan
  - `paused` boolean, nullable
  - `phones` Phone[]
    - `additional_priorities` unknown
    - `all_priorities` unknown[]
      - unknown
    - `blocked` boolean
    - `carrier` string, nullable
    - `created_at` unknown
    - `enabled` boolean
    - `id` integer
    - `phone` string
    - `priority` unknown
    - `rcs_unavailable_until_at` unknown
    - `source` string
    - `type` integer, nullable
  - `practice_id` string, required
  - `ssn` string, nullable
  - `tags` Tag[]
    - `id` integer
    - `name` string, nullable

## Response `200`

OK

- Patient
  - `address` Address
    - `city` string, required
    - `country` string
    - `country_short` string
    - `line2` string, nullable
    - `name` string, nullable
    - `state` string, required
    - `status` string
    - `street` string, required
    - `street_number` string
    - `text` unknown
    - `zip_code` string, required
  - `card_auth_on_file` boolean: The flag indicates if the patient has at least one payment method that is authorized for auto-pay
  - `collectly_id` string: Unique Collectly resource ID
  - `created_at` unknown
  - `current_balance` number
  - `date_of_birth` string, date, nullable
  - `emails` Email[]
    - `additional_priorities` unknown
    - `all_priorities` unknown[]
      - unknown
    - `created_at` unknown
    - `email` string, email
    - `enabled` boolean
    - `id` integer
    - `priority` unknown
    - `source` string
  - `external_balance` number
  - `external_refnum` string, nullable
  - `first_name` string, required
  - `gender` string, nullable: Allowed values: female, male, other
  - `guarantor` Guarantor
    - `address` unknown
    - `collectly_id` string: Unique Collectly resource ID
    - `created_at` unknown
    - `data` unknown
    - `date_of_birth` string, date, nullable
    - `external_id` string, nullable
    - `first_name` string, required
    - `id` string, required: Unique resource ID from your integration
    - `last_name` string, required
    - `middle_name` string, nullable
    - `modified_at` unknown
    - `practice_id` string, required
    - `ssn` string, nullable
  - `id` string, required: Unique resource ID from your integration
  - `insurance_policies` InsurancePolicy1[]
    - `collectly_id` string: Unique Collectly resource ID
    - `id` string, nullable
    - `insurance_company_collectly_id` integer, required
    - `is_archived` boolean
    - `member_id` string, nullable
    - `name` string, nullable
    - `patient_collectly_id` integer
    - `priority` string
  - `last_billing_cycle` BillingCycle
    - `billing_rule_id` integer
    - `billing_rule_name` string
    - `last_notification_time` unknown
    - `last_notification_type` string
    - `paused_by_patient_reply` boolean
    - `status` unknown
  - `last_name` string, required
  - `last_payment_date` string, date-time: Date and time of the patient's last payment
  - `metadata` unknown
  - `middle_name` string, nullable
  - `modified_at` unknown
  - `on_payment_plan` boolean: The flag indicates if the patient has an active payment plan
  - `paused` boolean, nullable
  - `phones` Phone[]
    - `additional_priorities` unknown
    - `all_priorities` unknown[]
      - unknown
    - `blocked` boolean
    - `carrier` string, nullable
    - `created_at` unknown
    - `enabled` boolean
    - `id` integer
    - `phone` string
    - `priority` unknown
    - `rcs_unavailable_until_at` unknown
    - `source` string
    - `type` integer, nullable
  - `practice_id` string, required
  - `ssn` string, nullable
  - `tags` Tag[]
    - `id` integer
    - `name` string, nullable

## Changes

- **2026-11-03** `a45575a6e4b8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/collectly/apis/partners1/changes/practices/:practice_id/patients/:patients/patch.md)

---

[API](https://skmtc.dev/collectly/apis/partners1.md) - [All operations](https://skmtc.dev/collectly/apis/partners1/llms.txt) - [OpenAPI document](https://skmtc.dev/collectly/apis/partners1/revisions/a45575a6e4b8?raw)