---
title: "POST /v1/notes"
method: POST
path: "/v1/notes"
tags: ["notes"]
---

# POST /v1/notes

`POST /v1/notes`

Creates a new note.

## Request body

- Note — A single note.
  - `trashed` boolean — Output only. `true` if this note has been trashed. If trashed, the note is eventually deleted.
  - `attachments` Attachment[] — Output only. The attachments attached to this note.
    - `name` string — The resource name;
    - `mimeType` string[] — The MIME types (IANA media types) in which the attachment is available.
  - `name` string — Output only. The resource name of this note. See general note on identifiers in KeepService.
  - `updateTime` string, google-datetime — Output only. When this note was last modified.
  - `createTime` string, google-datetime — Output only. When this note was created.
  - `title` string — The title of the note. Length must be less than 1,000 characters.
  - `trashTime` string, google-datetime — Output only. When this note was trashed. If `trashed`, the note is eventually deleted. If the note is not trashed, this field is not set (and the trashed field is `false`).
  - `permissions` Permission[] — Output only. The list of permissions set on the note. Contains at least one entry for the note owner.
    - `group` Group — Describes a single Group.
      - `email` string — The group email.
    - `deleted` boolean — Output only. Whether this member has been deleted. If the member is recovered, this value is set to false and the recovered member retains the role on the note.
    - `name` string — Output only. The resource name.
    - `role` 'ROLE_UNSPECIFIED' | 'OWNER' | 'WRITER' — The role granted by this permission. The role determines the entity’s ability to read, write, and share notes.
    - `family` Family — Describes a single Google Family.
    - `email` string — The email associated with the member. If set on create, the `email` field in the `User` or `Group` message must either be empty or match this field. On read, may be unset if the member does not have an associated email.
    - `user` User — Describes a single user.
      - `email` string — The user's email.
  - `body` Section — The content of the note.
    - `text` TextContent — The block of text for a single text section or list item.
      - `text` string — The text of the note. The limits on this vary with the specific field using this type.
    - `list` ListContent — The list of items for a single list note.
      - `listItems` ListItem[] — The items in the list. The number of items must be less than 1,000.
        - `childListItems` ListItem[] — If set, list of list items nested under this list item. Only one level of nesting is allowed.
        - `text` TextContent — The block of text for a single text section or list item.
          - `text` string — The text of the note. The limits on this vary with the specific field using this type.
        - `checked` boolean — Whether this item has been checked off or not.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/keep.md) · [All operations](https://skmtc.dev/google/apis/keep/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/keep/revisions/302ce571469e/schema)