---
title: "Create a care plan"
method: POST
path: "/api/2026-01-01/medical-record/care-plans"
tags: ["CarePlans"]
---

# Create a care plan

`POST /api/2026-01-01/medical-record/care-plans`

Create a care plan

## Request body

- CreateCarePlanRequest
  - `data` CarePlan
    - `id` string, uuid — UUIDv7 identifier for the care plan
    - `patient_id` string, uuid, required — Reference to the patient
    - `practitioner_id` string, uuid — Reference to the practitioner who performed/recorded the observation
    - `encounter_id` string, uuid — Reference to the encounter where the care plan was made
    - `category` 'treatment_plan', required — The classification of the type of care plan
    - `title` string — The title of the care plan
    - `description` string — The description of the care plan
    - `status` 'draft' | 'active' | 'on-hold' | 'revoked' | 'completed' | 'entered-in-error' | 'unknown' — The status of the care plan
    - `created_at` string, date-time — When the care plan record was created
    - `updated_at` string, date-time — When the care plan record was updated
    - `activities` CarePlanActivity[] — Array of care plan activities
      - `id` string, uuid — UUIDv7 identifier for the component
      - `category` 'appointment' | 'exercise' | 'medication' | 'nutrition', required — The classification of the type of care plan activity
      - `description` string — The description of the care plan activity
      - `progress` string — The progress of the care plan activity
      - `created_at` string, date-time — When the care plan activity record was created
      - `updated_at` string, date-time — When the care plan activity record was updated
    - `document_ids` string[] — Array of document upload IDs to attach to the care plan. All documents must exist and be verified.

## Response `201`

The care plan was created

- CarePlan
  - `id` string, uuid — UUIDv7 identifier for the care plan
  - `patient_id` string, uuid, required — Reference to the patient
  - `practitioner_id` string, uuid — Reference to the practitioner who performed/recorded the observation
  - `encounter_id` string, uuid — Reference to the encounter where the care plan was made
  - `category` 'treatment_plan', required — The classification of the type of care plan
  - `title` string — The title of the care plan
  - `description` string — The description of the care plan
  - `status` 'draft' | 'active' | 'on-hold' | 'revoked' | 'completed' | 'entered-in-error' | 'unknown' — The status of the care plan
  - `created_at` string, date-time — When the care plan record was created
  - `updated_at` string, date-time — When the care plan record was updated
  - `activities` CarePlanActivity[] — Array of care plan activities
    - `id` string, uuid — UUIDv7 identifier for the component
    - `category` 'appointment' | 'exercise' | 'medication' | 'nutrition', required — The classification of the type of care plan activity
    - `description` string — The description of the care plan activity
    - `progress` string — The progress of the care plan activity
    - `created_at` string, date-time — When the care plan activity record was created
    - `updated_at` string, date-time — When the care plan activity record was updated
  - `document_ids` string[] — Array of document upload IDs to attach to the care plan. All documents must exist and be verified.

## Other responses

- `400` — The care plan was not created

---

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