Create notes
Stay organized with collections
Save and categorize content based on your preferences.
The Google Keep API allows you to create two types of notes: a text note and a list
note. This document shows how to create each type.
Create a text note
The following sample shows how to create a text note:
Java
/**
* Creates a new text note.
*
* @throws IOException
* @return The newly created text note.
*/
private Note createTextNote(String title, String textContent) throws IOException {
Section noteBody = new Section().setText(new TextContent().setText(textContent));
Note newNote = new Note().setTitle(title).setBody(noteBody);
return keepService.notes().create(newNote).execute();
}
Create a list note
The following sample shows how to create a list note:
Java
/**
* Creates a new list note.
*
* @throws IOException
* @return The newly created list note.
*/
private Note createListNote() throws IOException {
// Create a checked list item.
ListItem checkedListItem =
new ListItem().setText(new TextContent().setText("Send meeting invites")).setChecked(true);
// Create a list item with two children.
ListItem uncheckedListItemWithChildren =
new ListItem()
.setText(new TextContent().setText("Prepare the presentation"))
.setChecked(false)
.setChildListItems(
Arrays.asList(
new ListItem().setText(new TextContent().setText("Review metrics")),
new ListItem().setText(new TextContent().setText("Analyze sales projections")),
new ListItem().setText(new TextContent().setText("Share with leads"))));
// Creates an unchecked list item.
ListItem uncheckedListItem =
new ListItem().setText(new TextContent().setText("Send summary email")).setChecked(true);
Note newNote =
new Note()
.setTitle("Marketing review meeting")
.setBody(
new Section()
.setList(
new ListContent()
.setListItems(
Arrays.asList(
checkedListItem,
uncheckedListItemWithChildren,
uncheckedListItem))));
return keepService.notes().create(newNote).execute();
}
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[],[],null,["# Create notes\n\nThe Google Keep API allows you to create two types of notes: a text note and a list\nnote. This document shows how to create each type.\n\nCreate a text note\n------------------\n\nThe following sample shows how to create a text note: \n\n### REST\n\nCall [notes.create](/workspace/keep/api/reference/rest/v1/notes/create) with a\n[Note](/workspace/keep/api/reference/rest/v1/notes#Note) resource. Place the\n[TextContent](/workspace/keep/api/reference/rest/v1/notes#TextContent) in the\n[Section](/workspace/keep/api/reference/rest/v1/notes#Section) of the note.\n\n### Java\n\n /**\n * Creates a new text note.\n *\n * @throws IOException\n * @return The newly created text note.\n */\n private Note createTextNote(String title, String textContent) throws IOException {\n Section noteBody = new Section().setText(new TextContent().setText(textContent));\n Note newNote = new Note().setTitle(title).setBody(noteBody);\n\n return keepService.notes().create(newNote).execute();\n }\n\nCreate a list note\n------------------\n\nThe following sample shows how to create a list note: \n\n### REST\n\nCall [notes.create](/workspace/keep/api/reference/rest/v1/notes/list) with a\n[Note](/workspace/keep/api/reference/rest/v1/notes#Note) resource. Place the\n[ListContent](/workspace/keep/api/reference/rest/v1/notes#ListContent) in the\n[Section](/workspace/keep/api/reference/rest/v1/notes#Section) of the note.\n\n### Java\n\n /**\n * Creates a new list note.\n *\n * @throws IOException\n * @return The newly created list note.\n */\n private Note createListNote() throws IOException {\n // Create a checked list item.\n ListItem checkedListItem =\n new ListItem().setText(new TextContent().setText(\"Send meeting invites\")).setChecked(true);\n\n // Create a list item with two children.\n ListItem uncheckedListItemWithChildren =\n new ListItem()\n .setText(new TextContent().setText(\"Prepare the presentation\"))\n .setChecked(false)\n .setChildListItems(\n Arrays.asList(\n new ListItem().setText(new TextContent().setText(\"Review metrics\")),\n new ListItem().setText(new TextContent().setText(\"Analyze sales projections\")),\n new ListItem().setText(new TextContent().setText(\"Share with leads\"))));\n\n // Creates an unchecked list item.\n ListItem uncheckedListItem =\n new ListItem().setText(new TextContent().setText(\"Send summary email\")).setChecked(true);\n\n Note newNote =\n new Note()\n .setTitle(\"Marketing review meeting\")\n .setBody(\n new Section()\n .setList(\n new ListContent()\n .setListItems(\n Arrays.asList(\n checkedListItem,\n uncheckedListItemWithChildren,\n uncheckedListItem))));\n\n return keepService.notes().create(newNote).execute();\n }"]]