---
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`

## Request

- Base URL: `https://jdpdocsdemo.jane.qa`
- URL: `https://jdpdocsdemo.jane.qa/api/2026-01-01/medical-record/care-plans`
- Auth: OAuth 2
  - Authorization code: `https://login.id.janeapp.com/realms/jane_partner_sandbox/protocol/openid-connect/auth?response_type=code&resource=https://jdpdocsdemo.jane.qa&prompt=consent`
  - Token URL: `https://login.id.janeapp.com/realms/jane_partner_sandbox/protocol/openid-connect/token` scopes: `care_plans:create`

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.
    - `documents` object[]: Array of document upload IDs currently attached to the care plan.
      - `id` string, uuid, required

## 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.
  - `documents` object[]: Array of document upload IDs currently attached to the care plan.
    - `id` string, uuid, required

## Other responses

- `400`: Invalid request data (schema validation failure)
- `404`: Patient not found or not accessible
- `422`: Care plan validation failed

## Changes

- **2026-11-03** `01798f613a5e`: 1 warning, 5 info
  - removed the optional property `object` from the response with the `400` status
  - the request optional property `data/document_ids` became write-only
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`
  - …2 more

[Operation history](https://skmtc.dev/jane/apis/jdp-api/changes/api/2026-01-01/medical-record/care-plans/post.md)

---

[API](https://skmtc.dev/jane/apis/jdp-api.md) - [All operations](https://skmtc.dev/jane/apis/jdp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jane/apis/jdp-api/revisions/01798f613a5e?raw)