Skip to content
REST API

Create an empty note

POST
/notes

Creates an empty note, optionally inside one of the user's folders. v1 does not write note content.

Required scopes: notes:create

Authorization

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Creates an EMPTY note. v1 does not write note content.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/notes" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "data": {    "id": "3c2b1a09-8f7e-4d6c-9b5a-4f3e2d1c0b9a",    "name": "Photosynthesis",    "folder": {      "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",      "name": "Biology",      "subject": null    },    "subject": null,    "created": "2026-01-15T09:30:00.000Z",    "updated": "2026-02-01T12:00:00.000Z",    "fullWidth": false,    "contentFormat": "tiptap",    "contentUnstable": true,    "content": {      "type": "doc",      "content": [        {          "type": "paragraph",          "attrs": {            "id": "6d5c4b3a-2f1e-4d0c-9b8a-7f6e5d4c3b2a"          },          "content": [            {              "type": "text",              "text": "Light becomes chemical energy."            }          ]        }      ]    },    "summary": {      "summary": "How plants turn light into sugar.",      "keywords": [        "chlorophyll",        "glucose",        "light reactions"      ],      "created": "2026-02-01T12:00:00.000Z"    }  }}