---
title: "Create a new Client Note"
method: POST
path: "/v2/clients/{clientId}/notes"
tags: ["Client Notes"]
---

# Create a new Client Note

`POST /v2/clients/{clientId}/notes`

Creates a new note for the given client.

## Path parameters

- `clientId` string, required

## Headers

- `Authorization` string, required

## Request body

- CreateClientNoteV2Dto
  - `note` string, required — The note content.
  - `pin` boolean — Whether the note is pinned to the top of the list.

## Response `201`

The created client note.

- ResponseClientNoteV2Dto
  - `id` string — The ID of the client note (prefix `CLN-`).
  - `note` string — The note content.
  - `pin` boolean — Whether the note is pinned to the top of the list.
  - `techName` string — The name of the user who created the note.
  - `createdAt` string — The date and time the note was created.

## Other responses

- `400` — Validation error (e.g. missing note content).
- `401` — Missing or invalid authentication token.
- `404` — No client with the given ID exists for this account.

---

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