Creating notes

This endpoint creates a new note.

HTTP Request

POST https://api.lunatask.app/v1/notes

Body Parameters

Parameter	Description
notebook_id	The Notebook ID of the notebook where the note should be created (optional, can be found in our apps in the notebook settings)
name	The name of the note (optional, but impractical if empty)
content	The content of the note (optional, but impractical if empty, formatted in Markdown)
source	Identification of external system where the note is coming from (optional, e.g. "evernote")
source_id	The ID of the record in the external system (optional, e.g. "352fd2d7-cdc0-4e91-a0a3-9d6cc9d440e7")

When creating a note, given there's already an existing note in the same notebook with the same source/source_id, the endpoint will return 204 No Content without creating a duplicate.

Whitespace handling in Markdown

Unfortunately, Markdown treats multiple consecutive blank lines as one blank line. To get around that and to allow a blank line between paragraphs in notes, prepend a backslash and a single space to all consecutive new lines except the first one.

This is the first line.<CR>
\ <CR>
This is the second line.

In this example, the <CR> marker signifies where new line breaks are placed. In most programming languages, the string representation would be "This is the first line.\n\\ \nThis is the second line.".

Example in Ruby

require 'rest-client'

access_token = 'xxx'

payload = {
  name: 'My new note',
  content: 'My important note content',
  source: 'evernote',
  source_id: '352fd2d7-cdc0-4e91-a0a3-9d6cc9d440e7',
  notebook_id: '11b37775-5a34-41bb-b109-f0e5a6084799'
}

RestClient.post('https://api.lunatask.app/v1/notes', payload.to_json, { Authorization: "bearer #{access_token}", "Content-Type": 'application/json' })

Response

The above command returns JSON structured like this:

{
  "note": {
    "id": "5999b945-b2b1-48c6-aa72-b251b75b3c2e",
    "notebook_id": "d1ff35f5-6b25-4199-ab6e-c19fe3fe27f1",
    "sources": [
      {
        "source": "evernote",
        "source_id": "352fd2d7-cdc0-4e91-a0a3-9d6cc9d440e7"
      }
    ],
    "created_at": "2021-01-10T10:39:25Z",
    "updated_at": "2021-01-10T10:39:25Z",
    "deleted_at": null
  }
}