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

# Create a note

`POST /me/notes`

Pass any paragraph reference format. Multiple notes per paragraph are allowed. Format: 'plain' (default) or 'markdown'.

## Request body

- object
  - `ref` string, required — Paragraph reference in any format
  - `text` string, required
  - `format` 'plain' | 'markdown'

## Response `201`

Note created

- object
  - `data` object, required
    - `id` string, uuid, required
    - `text` string, required
    - `format` string, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `paragraph` object, required
      - `id` string, required
      - `standardReferenceId` string, required
      - `sortId` string, required
      - `paperId` string, required
      - `sectionId` string, nullable, required
      - `partId` string, required
      - `paperTitle` string, required
      - `sectionTitle` string, nullable, required
      - `paragraphId` string, required
      - `text` string, required
      - `htmlText` string, required
      - `language` string
      - `labels` string[], nullable, required
      - `audio` object, nullable, required
      - `entities` object[]
        - `id` string, required
        - `name` string, required
        - `type` 'being' | 'place' | 'order' | 'race' | 'religion' | 'concept', required
      - `bibleParallels` object[]
        - `chunkId` string, required
        - `reference` string, required
        - `bookCode` string, required
        - `chapter` integer, required
        - `verseStart` integer, required
        - `verseEnd` integer, required
        - `text` string, required
        - `similarity` number, required
        - `rank` integer, required
        - `source` string, required
        - `embeddingModel` string, required
      - `urantiaParallels` object[]
        - `id` string, required
        - `standardReferenceId` string, required
        - `paperId` string, required
        - `paperTitle` string, required
        - `sectionTitle` string, nullable, required
        - `text` string, required
        - `similarity` number, required
        - `rank` integer, required
        - `source` string, required
        - `embeddingModel` string, required

## Other responses

- `401` — Authentication required
- `404` — Paragraph not found

---

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