---
title: "Create Note"
method: POST
path: "/v1.0/notes"
tags: ["Notes"]
---

# Create Note

`POST /v1.0/notes`

Creates a note on the target lead.

Notes:
- leadId, content and isPin are required; content must not be blank.
- content is silently truncated to 2000 characters.
- Caller must have access to the lead; otherwise 404 LEAD_NOT_EXIST.
- The response contains only the new note's ID under the 'noteId' key.
- Persistence is asynchronous: subsequent GET and PUT on the returned noteId may briefly return 404 immediately after create. DELETE is unaffected.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- NoteRequest — Note payload.
  - `content` string, required — Note content. Silently truncated to 2000 characters.
  - `leadId` integer, required — ID of the lead this note belongs to. Must be accessible to the caller.
  - `isPin` boolean, required — Whether to pin this note to the top of the lead's timeline.

## Response `200`

Note created. Response contains the new note's ID.

- NoteIdResponse — Wrapped response for POST /v1.0/notes. The new note's ID is returned under the 'noteId' key.
  - `noteId` integer — ID of the newly created note.

## Other responses

- `400` — Missing or invalid parameter: leadId is -1, content is blank, or isPin is null (20012 INVALID_PARAMETER).
- `401` — Missing or invalid authentication token.
- `404` — Lead does not exist, is trashed, or is not accessible to the caller (20006 LEAD_NOT_EXIST).
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/versions/23e640467118/schema)