Prospect Notes

Method	Path	Description
`GET`	`/v1/prospects/{id}/notes`	List notes, newest first (paged)
`POST`	`/v1/prospects/{id}/notes`	Add a note
`GET`	`/v1/prospects/{id}/notes/{note_id}`	Get one note
`PATCH`	`/v1/prospects/{id}/notes/{note_id}`	Edit the body
`DELETE`	`/v1/prospects/{id}/notes/{note_id}`	Delete the note

body bodystringrequired

The note, 1 to 10,000 characters. Used by POST and PATCH.

Request example

1234curl -X POST "https://api.v2.dealmachine.com/v1/prospects/prospect_8812/notes" \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Owner called back, wants an offer by Friday" }'

Response example

12345678910{
  "data": {
    "id": "note_9",
    "prospect_id": "prospect_8812",
    "body": "Owner called back, wants an offer by Friday",
    "author": { "type": "api_key", "user_id": null, "name": null, "api_key_id": "key_9f1c..." },
    "created_at": "2026-08-26T16:20:00.000Z",
    "updated_at": "2026-08-26T16:20:00.000Z"
  }
}