---
title: "Create a Note"
method: POST
path: "/notes"
tags: ["Notes"]
---

# Create a Note

`POST /notes`

Creates a note for one or more contacts.

Supported content formats: plaintext and Markdown.

## Request body

- object
  - `note` NoteInput
    - `content` string, required — Plaintext or markdown note content as a string.
    - `note_tag_id` string, uuid — Note tag ID to associate with the note.
    - `contact_ids` string[], required — Contact IDs to associate with the note.

## Response `201`

Note successfully created

- object
  - `note` Note
    - `id` string, uuid, required — Unique identifier for the note
    - `contact_ids` string[], nullable — Contact IDs associated with the note when the note belongs to contacts.
    - `note_tag_id` string, uuid, nullable — The note tag ID associated with the note
    - `content` string, nullable — Content of the note. May be null immediately after create while asynchronous processing completes.
    - `created_at` string, date-time, required — When the note was created

## Other responses

- `400` — Bad Request - The request is invalid or malformed
- `401` — Unauthorized - Invalid or missing authentication token
- `403` — Forbidden - The authenticated user does not have access to the requested resource
- `422` — Unprocessable Entity - The request is valid but contains semantic errors
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/visible/apis/visible-api-2.md) · [All operations](https://skmtc.dev/visible/apis/visible-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/visible/visible-api-2/revisions/d63a3bb6d361/schema)