> ## Documentation Index
> Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a patient note

> Creates a new patient note for a clinic patient and adds it to the patient's timeline. Notes created via the API are automatically locked (cannot be edited by clinic staff after creation).

Patient notes support different kinds (e.g., general, communication) and can be marked as internal (visible only to clinic staff) or external (also visible to pet parents).



## OpenAPI

````yaml post /ext/v2/patient-notes/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/patient-notes/:
    post:
      tags:
        - Clients And Patients
      summary: Create a patient note
      description: >-
        Creates a new patient note for a clinic patient and adds it to the
        patient's timeline. Notes created via the API are automatically locked
        (cannot be edited by clinic staff after creation).


        Patient notes support different kinds (e.g., general, communication) and
        can be marked as internal (visible only to clinic staff) or external
        (also visible to pet parents).
      operationId: patient_notes_create
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExternalPatientNoteCreateSchema'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalPatientNoteDetailSchema'
          description: Created
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalPatientNoteCreateSchema:
      properties:
        clinic_patient_id:
          description: The ID of the clinic patient this note is associated with
          title: Clinic Patient Id
          type: integer
        created_by_id:
          anyOf:
            - type: integer
            - type: 'null'
          description: The ID of the user who created this note
          title: Created By Id
        is_internal:
          default: true
          description: Whether this note is internal or visible to clients
          title: Is Internal
          type: boolean
        kind:
          $ref: '#/components/schemas/ExternalPatientNoteKindForCreate'
          description: >-
            The kind of patient note. Documentation notes are not supported via
            external API.
        note:
          description: The note content as plain text
          title: Note
          type: string
      required:
        - clinic_patient_id
        - kind
        - note
      title: ExternalPatientNoteCreateSchema
      type: object
    ExternalPatientNoteDetailSchema:
      description: >-
        Patient notes are used to record information about a patient that should
        appear on their timeline. Notes can be of different kinds (general,
        communication, documentation) and can be marked as internal (visible
        only to clinic staff) or external (visible to clients as well).
      properties:
        clinic_patient_id:
          description: The ID of the clinic patient this note is associated with
          title: Clinic Patient Id
          type: integer
        created_by_name:
          anyOf:
            - type: string
            - type: 'null'
          description: The full name of the user who created this note
          title: Created By Name
        date:
          description: The date and time when the note was created
          format: date-time
          title: Date
          type: string
        deleted:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: The datetime this record was soft deleted.
          title: Deleted
        details:
          anyOf:
            - items:
                type: object
              type: array
            - type: 'null'
          description: Additional details about the note in JSON format
          title: Details
        id:
          description: The unique identifier for the patient note
          title: Id
          type: integer
        is_deleted:
          description: Whether this record is soft deleted or not.
          title: Is Deleted
          type: boolean
        is_internal:
          description: Whether this note is internal or visible to clients
          title: Is Internal
          type: boolean
        is_locked:
          description: Whether this note is locked and cannot be modified
          title: Is Locked
          type: boolean
        kind:
          anyOf:
            - $ref: '#/components/schemas/PatientNoteKind'
            - const: ''
              type: string
          description: The kind of patient note
          title: Kind
      required:
        - is_deleted
        - deleted
        - id
        - clinic_patient_id
        - kind
        - is_internal
        - is_locked
        - details
        - date
      title: ExternalPatientNoteDetailSchema
      type: object
    ExternalPatientNoteKindForCreate:
      enum:
        - GENERAL
        - COMMUNICATION
      title: ExternalPatientNoteKindForCreate
      type: string
    PatientNoteKind:
      enum:
        - GENERAL
        - COMMUNICATION
        - DOCUMENTATION
      title: PatientNoteKind
      type: string
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````