---
title: "Create a note"
method: POST
path: "/notes"
---

# Create a note

`POST /notes`

Create a note from markdown, html, or sliteml content, with a templateId or
just an empty one. If no parentNoteId is specified, it will be created in your
personal channel.

## Request body

- object
  - `title` string, required — Title of the note to create
  - `parentNoteId` string — Below which other note to create this note. If not specified, the note would be created in your personal channel
  - `templateId` string — If you want to apply a template to the created note
  - `markdown` string, blob
  - `html` string
  - `attributes` string[] — Attributes for the parent collection ordered by column. If they don't match the appropriate type, they would be ignored
  - `sliteml` string

## Response `200`

Ok

- Note
  - `owner` NoteOwner — Owner of the note for review purposes. Either userId or groupId will be set, but not both.
    - `groupId` string — Group id of the owner (if owner is a group)
    - `userId` string — User id of the owner (if owner is a user)
  - `reviewState` 'Verified' | 'Outdated' | 'VerificationRequested' | 'VerificationExpired'
  - `archivedAt` string, date-time, nullable, required — Date of the archiving of the note (null if not archived)
  - `lastEditedAt` string, date-time, required — Date of the last edition of the note
  - `updatedAt` string, date-time, required — Date of the last update of the note
  - `createdAt` string, date-time, required — Date of the creation of the note
  - `columns` string[] — If note is in a collection, it will contain its column names
  - `attributes` string[] — If note is in a collection, it will contain its attributes ordered by column
  - `url` string, required — Url to the note
  - `listPosition` number, double, nullable — Position of the note among its siblings, matching the order shown in the Slite sidebar. Higher values come first (top of the sidebar). By default it is seeded from the creation date, so freshly created docs appear at the top; manual reordering overrides it. Combine with `orderBy=listPosition_DESC` on the children endpoint to reproduce the sidebar order. Null when the note has no explicit position.
  - `parentNoteId` string, nullable, required — Parent note id of the current note. It can be null if it's a root note.
  - `iconColor` string, nullable — Optional icon color for the note.
  - `iconShape` string, nullable — Optional icon identifier for the note.
  - `title` string, required — Title of the note
  - `id` string, required — Id of the note

## Other responses

- `401` — Invalid authentication
- `422` — Input validation error
- `429` — Rate limitation error
- `default` — Unexpected error

---

[API](https://skmtc.net/slite/apis/public-slite-api.md) · [All operations](https://skmtc.net/slite/apis/public-slite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slite/public-slite-api/versions/7cee1a5a5128/schema)