---
title: "Create a note on a case"
method: POST
path: "/cases/{id}/notes"
tags: ["Cases"]
---

# Create a note on a case

`POST /cases/{id}/notes`

Creates a new note/comment on a collection case.

**Use Case:**
Use this endpoint to document activities, record conversations, add reminders, or log any relevant information about the case. Notes are automatically shared with the creditor.

**Validation:**
- Description is required (max 10000 characters)
- EventDate must not be in the future (if provided)

**EventDate:**
Supply EventDate to back-date the note to the time the event actually occurred. For example, if a phone call happened three days ago, pass that date so the timeline reflects the real event order. Omit for real-time notes.

## Path parameters

- `id` string, uuid, required

## Request body

- DebituraWebExternalApiContractsV1NotesCreateNoteRequest — Request to create a new note on a case
  - `description` string, required — Note content
  - `eventDate` string, date-time, nullable — The date when the event actually occurred. Must not be in the future. When provided, the note will appear at this date in the timeline instead of the upload time. This is useful for importing historical events (e.g. a phone call that happened last week). Omit or set to null to use the current time (default behaviour).

## Response `200`

Note created successfully

- DebituraWebExternalApiContractsV1NotesNoteDto — Note details response
  - `id` string, uuid
  - `caseReference` string, nullable, required
  - `title` string, nullable, required
  - `description` string, nullable
  - `visibility` string, nullable, required
  - `createdAt` string, date-time
  - `eventDate` string, date-time, nullable — The event date provided at creation time. Null if no EventDate was supplied, meaning the note was recorded in real-time (CreatedAt reflects the actual event time).
  - `createdBy` DebituraWebExternalApiContractsV1NotesNoteCreatedByDto
    - `userId` integer
    - `userName` string, nullable, required

## Other responses

- `400` — Invalid request (missing required fields, EventDate in the future, or validation errors)
- `404` — Case not found or not assigned to you
- `500` — Server error occurred

---

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