---
title: "Create a new clinical note"
method: POST
path: "/v1/notes"
tags: ["Notes"]
---

# Create a new clinical note

`POST /v1/notes`

Creates a new note

## Request body

- CreateNotePayload
  - `transcript` string, required — The raw medical transcript text to be processed into a clinical note
  - `date` string, date, required — Date of the patient encounter
  - `language` 'en' | 'es' | 'fr' | 'de' | 'it' | 'pt' | 'ru' | 'zh' — Language code for the transcript content. While multiple languages are supported, English ('en') is recommended for optimal output quality and accuracy.
  - `noteType` object — Configuration object specifying the style and format of the generated note
    - `description` string — A brief overview of the note.
    - `type` 'soap' | 'note_style' | 'note_template' — Determines the type of note to generate. - Use `note_style` to provide a note style string - Use `note_template` to provide a [Note Template](/api-reference/schemas/note-template) payload - Use `soap` for the default SOAP template
    - `template` union — Custom template to generate the note. This is applicable only when `type` is set to `note_style` or `note_template`. - When `type` is `note_style`, this is a note style string - When `type` is `note_template`, this is a [Note Template](/api-reference/schemas/note-template) payload
      - string
      - object
    - `includeJson` boolean — Determines whether to include a JSON payload in the custom note output. This option is applicable only for custom notes and defaults to `false`. Enabling this will increase latency and payload size.
  - `patientInfo` object — Optional patient information
    - `name` string — Patient's full name
    - `dateOfBirth` string, date — Patient's date of birth in ISO-8601 format (YYYY-MM-DD)
    - `gender` 'male' | 'female' | 'other' | 'prefer not to say' | 'unspecified' — Patient's gender identity
  - `previousNote` string — Reference to a previous note if this is a follow-up. This field is optional.
  - `context` string, nullable — Additional context for note generation. This field is optional.
  - `instructions` string[], nullable — Special instructions for note generation. This field is optional.
  - `medicationList` string — List of up to 50 medications (comma separated) to use as reference for fixing spelling errors. This field is optional.

## Response `200`

Note response

- CreateNoteResponse
  - `status` string — Status of the response
  - `data` object
    - `noteId` string — Unique identifier for the created note
  - `date` string, date-time — Timestamp of the response

## Other responses

- `400` — unexpected error

---

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