---
title: "Create Clinical Note Interaction"
method: POST
path: "/provider/patients/{patient_id}/interactions/clinical_note"
tags: ["ClinicalNoteInteraction"]
---

# Create Clinical Note Interaction

`POST /provider/patients/{patient_id}/interactions/clinical_note`

## Path parameters

- `patient_id` string, required

## Request body

- InteractionClinicalNoteSanitizer
  - string — status [draft, signed, addended, deleted, failed] The status of the interaction.
  - `title` string — The title of the interaction.
  - `text` string — The plain text body of the interaction.
  - `formatted_text` string — The formatted text body (markdown). Converted to HTML server-side.
  - `event_timestamp` string, date-time — The event timestamp of the interaction.
  - `files` string[] — File attachment paths. Files will be downloaded as part of the request.
  - `provider_name` string — Name of the signing provider. When provided with status "signed", the API resolves it to a provider user ID for the signed field.
  - `integration_record_id` string
  - `integration_error_message` string
  - `integration_web_link` string

## Response `200`

Successful response

- PublicInteractionClinicalNoteBlueprintOne
  - `id` string
  - `author` string
  - `event_timestamp` string, date-time
  - `files` string
  - `formatted_text` string
  - `patient_access` boolean
  - `patient_id` string
  - `signed` string
  - `status` string
  - `text` string
  - `title` string
  - `type` string

---

[API](https://skmtc.net/hint/apis/partner-endpoints.md) · [All operations](https://skmtc.net/hint/apis/partner-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hint/partner-endpoints/revisions/a92ae2a6fa90/schema)