> ## Documentation Index
> Fetch the complete documentation index at: https://developers.qomon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Create, read, update, delete, and pin notes on a contact.

## Note object

A note is a free-text entry attached to a single contact, optionally pinned to the top of that contact's page. Notes belong to a contact and to the space (API key) that created them.

```json theme={"system"}
{
  "id": 501,
  "contact_id": 42,
  "content": "Called to confirm address, will follow up next month.",
  "pinned": true,
  "created_at": "2026-07-30T18:00:00Z",
  "updated_at": "2026-07-30T18:00:00Z"
}
```

## Key fields

| Field | Meaning |
| :- | :- |
| `content` | The note's text. |
| `pinned` | Whether the note is pinned to the top of the contact's page. |
| `contact_id` | The contact this note is attached to. |

Internal-only notes (restricted to users with the private-notes permission) are not exposed through this API: you will only see and create notes visible to the group at large.

## Updating notes

`PUT /v1/contacts/{contactId}/notes/{noteId}` is a full replace: any field omitted from the request — including `pinned` — is cleared. Always resend the full note if you only intend to change one field.

## Endpoints

| What you need | Endpoint |
| :- | :- |
| Create a note | `POST /v1/contacts/{contactId}/notes` |
| List a contact's notes | `GET /v1/contacts/{contactId}/notes` |
| Get a note | `GET /v1/contacts/{contactId}/notes/{noteId}` |
| Update a note | `PUT /v1/contacts/{contactId}/notes/{noteId}` |
| Delete a note | `DELETE /v1/contacts/{contactId}/notes/{noteId}` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.