Contacts::Events::Note

List Contact Activity Notes

Changed on

Read only contact notes from the Activity tab, including API, UI and workflow notes. Ordered by created_at then id with the standard row-id cursor and sort_order. sort_property is not supported. Note ids are also event ids. MessageHub conversations are excluded. Numeric and public IDs are accepted.

get/contacts/{contact_id}/events/notes

Request

Path parameters

contact_idstring required

Query parameters

afterstring

ID of item after which the collection should be returned. More examples and info about pagination in our guides.

per_pageinteger

Records per page. Defaults to 20; raise it up to 100 for bulk reads. A larger value returns 100 records. Zero, a negative or a non-integer value is a 422. The Link next-page URL keeps the value, so a client following it keeps the page size. More in our guides.

sort_order'asc' | 'desc'

Sort order of a list response. Use 'desc' to reverse the default 'asc' (ascending) sort order. Examples in our guides.

Response

OK

idinteger

The same id as the contact event.

public_idstring
contact_idinteger
contentstring nullable

The note text. Legacy blank notes may be null.

created_by_idinteger nullable

Membership id; uses the recorded membership or the author's membership in this workspace's team. Workflow notes have no author and return null.

occurred_atstring date-time
created_atstring date-time
updated_atstring date-time

Example response

[
  {
    "id": 912345679,
    "public_id": "GhIjKl",
    "contact_id": 123,
    "content": "Called about the refund; promised a callback on Friday.",
    "created_by_id": 456,
    "occurred_at": "2026-10-12T14:03:00.000Z",
    "created_at": "2026-10-13T09:15:22.000Z",
    "updated_at": "2026-10-13T09:15:22.000Z"
  }
]

Changes