Add Note

The Add Note API allows you to create a new note and associate it with an existing document in the system. This endpoint is used to record comments, updates, or supplemental information linked to specific entities such as lending accounts, customers, vehicles, or other supported doctypes.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Request Body

The request body includes the content of the note and the document it should be associated with.

Response Structure

The response returns the full details of the newly created note, including its unique identifier, creator information, timestamps, the note text itself, and the document it is linked to. It also includes system metadata such as status flags, author, and event properties used for internal tracking and UI display.

  • name – Unique ID automatically generated for the note.
  • owner – User who initially created the note.
  • creation – Timestamp of when the note was created.
  • modified – Timestamp of the last modification.
  • modified_by – User who last modified the note.
  • docstatus – Document status flag (0 = Draft, 1 = Submitted, 2 = Cancelled).
  • idx – System index value used internally.
  • author – User who authored the note content.
  • note – The actual text of the note.
  • reference_doctype – The type of document this note is linked to.
  • reference_document – The specific ID of the linked document.
  • is_system – Indicates whether the note was system-generated (0 = No, 1 = Yes).
  • event_type – Optional event category associated with the note.
  • event_color – Color tag used for UI display of events or notes.
  • is_edited – Indicates if the note content was edited after creation.
  • doctype – The Frappe/ERPNext doctype name: "Document Note".

Example Response

{
    "data": {
        "name": "fpjdu8v30f",
        "owner": "[email protected]",
        "creation": "2025-12-14 23:59:51.700722",
        "modified": "2025-12-14 23:59:51.700722",
        "modified_by": "[email protected],
        "docstatus": 0,
        "idx": 0,
        "author": "[email protected]",
        "note": "Note 2",
        "reference_doctype": "LMS Lending Accounts",
        "reference_document": "LA-002886",
        "is_system": 0,
        "event_type": "",
        "event_color": "green",
        "is_edited": 0,
        "doctype": "Document Note"
    }
}
Body Params
string
required

The text content of the note being added.

string
required

The type of document the note relates to—in this case, an LMS Lending Account.

string
required

The reference_document field identifies the specific document record, such as LA-002886.

Response
200

Sucess Response

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!