# Create a note in a project

Creates a new note in the top level of the project project_id.

Notes are text comments displayed beside scripts and folders in the project view,
allowing for additional notes, comments or instructions to be displayed at the
project/folder and folder report levels.

The new note is supplied as a JSON object in the request body with the
contents of the note in the name field. This might seem like an odd
choice of field name, but is used for consistency with the other types of items
found in projects and folders, namely Folders, Scripts and Notes.
All project/folder items have a name field, which is the text displayed in the
project/folder view. As such, the contents of a Note are in fact its displayed "name".

Endpoint: POST /projects/{project_id}/notes
Version: 1.0

## Path parameters:

  - `project_id` (integer, required)
    The project ID.

## Query parameters:

  - `insert` (string)
    Controls where the note will be created within the top-level items

first (default) — the note is placed at the top of the project.  
last — the note is placed at the end of the project's contents.  
N - integer — the note is placed after the Nth item in the project.

## Request fields (application/json):

  - `name` (string)
    The contents of the new note, effectively its "name" in the same way scripts and folders
have names that are displayed as items in folders.


## Response 200 fields