v1

latestOpenAPI 3.0.22026-07-261040577.4 KB
Notes

Create note

Create a new data entry (note) within a Dovetail project. Data entries capture raw research data — interview transcripts, survey responses, or session recordings. They must be associated with a project via project_id.

Note: The notes resource has been renamed to data in Dovetail. New integrations should use Create data (POST /v1/data) instead.

You can provide the initial content as plain text or HTML via the content field, and attach custom field data via the fields array.

Returns the note object without the content body.

🚧 Permissions

Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

post/v1/notes

Request body

titlestring

The note's title.

contentstring

The initial content of the note, which may include plain text or HTML content.

project_idstring required

Unique identifier of the project that the note is associated with.

Example request

{
  "title": "My First Note",
  "content": "This is my new note that will talk about the key learnings of the interview."
}

Response

201