---
title: "Create, update or clear a note on a Care Folder"
method: POST
path: "/ws/sav/{careFolderId}/note"
tags: ["Care"]
---

# Create, update or clear a note on a Care Folder

`POST /ws/sav/{careFolderId}/note`

## Request

- Base URL: `https://preprod.backmarket.co.jp`
- URL: `https://preprod.backmarket.co.jp/ws/sav/{careFolderId}/note`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP basic
- TypeScript: <https://skmtc.dev/backmarket/apis/back-market-api-guidelines/docs/ws/sav/:careFolderId/note/post.ts> (a function with typed inputs; its response is checked against the schema)

Save a note on a Care Folder to keep track of information related to it.
Calling this endpoint again replaces the existing note. Passing `null` in the `note` field clears the note.

## Important notes

Notes are only supported on Care folders with an ID of 100,000,000 and above.
Care folders with an ID below 100,000,000 are not supported and return a `404`.

## Path parameters

- `careFolderId` integer, required

## Request body

- PostNoteRequest
  - `note` string, nullable: The note content to save on the Care Folder. Passing `null` clears the note.

## Response `200`

Note saved

- PostNoteResponse
  - `note` string, nullable: The note saved on the Care Folder

## Other responses

- `401`: Guest user not allowed
- `403`: Authenticated user not allowed
- `404`: Care Folder does not exist or does not support notes
- `422`: The note exceeds the maximum length of 2000 characters

## Changes

- **2026-10-06** `30a7402bb310`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/backmarket/apis/back-market-api-guidelines/changes/ws/sav/:careFolderId/note/post.md)

---

[API](https://skmtc.dev/backmarket/apis/back-market-api-guidelines.md) - [All operations](https://skmtc.dev/backmarket/apis/back-market-api-guidelines/llms.txt) - [OpenAPI document](https://skmtc.dev/backmarket/apis/back-market-api-guidelines/revisions/30a7402bb310?raw)