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

# Create a note

`POST /api/notes`

Note + shares + the author's reminder, in one transaction.

The `note_shared` fan-out happens only AFTER the commit, and targets exactly
the recipient set the DB actually inserted.

## Headers

- `x-api-token` string, nullable

## Request body

- NoteCreate
  - `body` string, required
  - `title` string, nullable
  - `priority` integer
  - `color` string, nullable
  - `due_at` string, nullable
  - `pinned` boolean
  - `id_modulo` integer, nullable
  - `id_modulo_id` integer, nullable
  - `recipients` integer[]
  - `reminder` ReminderPayload
    - `channel` string, nullable
    - `next_fire_at` string, nullable
    - `recurrence_unit` string, nullable
    - `recurrence_interval` integer, nullable
    - `snoozed_until` string, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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