GoHighLevel Contacts API

Update Note

PUT/contacts/:contactId/notes/:id

PUT /contacts/:contactId/notes/:id Update an existing note on a contact — its body, title, colour, or pinned state — identified by the note ID in the path. It takes 2 path parameters and 5 body fields, requires the contacts.write scope and authenticates with a sub-account (location) token.

Request and authentication

Method: PUT
Full URL: https://services.leadconnectorhq.com/contacts/:contactId/notes/:id
Scopes: contacts.write
Token type: Sub-account (location) token
Accepted auth: OAuth Access Token, Private Integration Token
API version header: Version: 2021-07-28
Schema verified: 22 June 2026

Path parameters

Substituted into the URL. Required by definition.

Name	Type	Description
`contactId`required	`string`	Example: `sx6wyHhbFdRXh302LLNR`
`id`required	`string`	Example: `ocQHyuzHvysMo5N5VsXc`

Request body

JSON body fields. Nested objects are shown indented under their parent.

Name	Type	Description
`userId`	`string`	Example: `GCs5KuzPqTls7vWclkEV`
`body`	`string`	Example: `lorem ipsum`
`title`	`string`	Example: `Follow-up summary`
`color`	`string`	Example: `#FFAA00`
`pinned`	`boolean`	Example: `false`

Response fields

Top-level fields returned on a successful call.

Name	Type	Description
`note`	`object`	—
`└id`	`string`	Example: `HGPcayliwcdoUFzvbTok`
`└body`	`string`	Example: `lorem ipsum`
`└userId`	`string`	Example: `TUcmRxWrjqzJS8EjkxNK`
`└dateAdded`	`string`	Example: `2021-07-08T12:02:11.285Z`
`└contactId`	`string`	Example: `TUcmRxWrjqzJS8EjkxNK`
`└title`	`string`	Example: `Follow-up summary`
`└color`	`string`	Example: `#FFAA00`
`└pinned`	`boolean`	Example: `false`

Example request

Copy-paste ready. Swap YOUR_TOKEN for your access token or Private Integration Token, and the sample IDs for your own.

curl -X PUT 'https://services.leadconnectorhq.com/contacts/sx6wyHhbFdRXh302LLNR/notes/ocQHyuzHvysMo5N5VsXc' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28' \
  -H 'Content-Type: application/json' \
  -d '{
    "userId": "GCs5KuzPqTls7vWclkEV",
    "body": "lorem ipsum",
    "title": "Follow-up summary"
  }'

Skip the schema lookup

Hylo gives your AI agent this schema — and the other 52 documented here — without you looking anything up. Ask in plain English; it picks the endpoint, fills the body, and can run the call against your own sub-account.

View pricing Read the setup guide

More contacts endpoints