On this page
A client note is a short piece of context that stays with the person, not with one chat: an allergy, a preferred time, the name of their assistant. VGraple CRM shows the same notes on the Contacts page, in the inbox information panel and through the REST API, so whoever opens the contact sees what the team already knows.
What a client note is for
A client note is the short, durable context that belongs to the person rather than to one chat. Three examples show the idea:
- A salon records that a client is allergic to a particular dye, so whoever takes the next booking sees it before they confirm the service.
- A wholesaler records that a buyer only accepts deliveries on Tuesdays and that their assistant, not the owner, places the orders.
- A clinic records that a patient prefers messages in the evening and should never be offered a morning slot.
None of these belong in a lead card, because a lead is one deal that opens and closes. None of them belong in one conversation either, because the person will write to you again next month in a new conversation. A client note is attached to the contact itself, so it is there every time that contact is opened, whichever conversation, lead or teammate you arrive from.
Before you start
- Reading notes needs the permission to view contacts. Adding and deleting needs the "Edit contacts" permission. Owners and admins have both.
- A note is limited to 5,000 characters.
- Notes are internal. They are never sent to the customer in a WhatsApp message.
- A note belongs to the contact, so deleting a lead never removes it.
Where client notes appear
The same notes show in three places, and a note added in one place appears in the others:
- The inbox information panel. Open a conversation and look at the information panel beside the thread. Client notes are listed there.
- The Contacts page. Select a contact to open the side panel, or open the contact's own page. The Client notes section sits below Leads and above Record.
- The REST API.
GET /api/v1/contacts/{id}/notesreturns the same list, andPOSTto the same address adds a note.
If a note you added in the inbox is not visible on the Contacts page, reload the contact: the panel loads its notes each time a contact is opened.
Add a note from the Contacts page
- Open Contacts and select a contact to open their panel, or open the contact's own page.
- Find the Client notes section.
- Select Add note, choose a type, write the note and select Save note.
The note appears at the top of the list with your name and the time. If saving fails, an error appears under the form and your text stays in the box so you can try again.
Note types
| Type | Use it for |
|---|---|
| General | Anything the team should know |
| Medical / Allergy | Health details that matter before a service or an order |
| Private | A label for sensitive context. It does not restrict who can read the note |
| Popup alert | Something that must be seen: it shows as an alert when the contact's chat is opened |
The type is a label that helps your team scan the list. It does not change who can read the note. A Private note can be read by every teammate who can open the contact and by every API key of your workspace, so keep anything that your whole team should not see out of client notes altogether.
Delete a note
Select the bin icon on a note, then Delete to confirm, or Keep to cancel. You can delete your own notes. Owners and admins can delete any note, including one that was written through the API. If you try to delete a note that is not yours and you are not an owner or admin, the page tells you so and the note stays.
Client notes and internal notes
VGraple CRM has two kinds of note and they answer different questions:
| Client note | Internal note | |
|---|---|---|
| Belongs to | The contact | One conversation |
| Seen in | Contacts, the inbox information panel, the API | The conversation's Internal Notes tab |
| Survives a new conversation | Yes | No, a new conversation starts empty |
| Supports teammate mentions | No | Yes |
Use an internal note to hand a single chat to a colleague. Use a client note for anything you want to still know in six months. The tags, notes and stages guide covers internal notes in full.
Add a note from another system
Use a full-access API key. A read-only key can list notes but cannot write one. Keys are created in Settings under API, and the REST API quickstart walks through the first call.
To list a contact's notes, newest first:
GET /api/v1/contacts/{id}/notes
Authorization: Bearer vgk_...
To add one:
POST /api/v1/contacts/{id}/notes
Authorization: Bearer vgk_...
Content-Type: application/json
{ "body": "Prefers evening delivery", "note_type": "general" }
body is required, trimmed, and up to 5,000 characters. note_type is general, medical, private or popup and defaults to general. A successful write answers 201 with the note. Each note in a response carries these fields:
| Field | Meaning |
|---|---|
id | The note's id |
note_type | One of the four types |
body | The note text |
created_at, updated_at | Timestamps in UTC |
author | Who wrote it: id, name and avatar_url |
source | user for a note written in the app, api for a note written with a key |
A note written with a key has no person behind it, so the app shows the key's name as its author, and source is api. If the key is later deleted, the note stays and is shown as written by the API.
Errors you may meet
| Answer | Meaning | What to do |
|---|---|---|
| 400 | The body is empty or longer than 5,000 characters, or the type is not one of the four | Fix the request and send it again |
| 401 | The key is missing, wrong or revoked | Send a valid key in the Authorization header |
| 403 | The key is read-only | Create a full-access key for integrations that write |
| 404 | The contact does not exist in your workspace | Check the contact id. A contact of another workspace is never visible |
Notes calls count towards the same per-minute workspace limit as the rest of the API (60 to 600 a minute, by plan).
Troubleshooting
| What you see | Likely cause | Fix |
|---|---|---|
| The Add note button is missing | Your role does not include "Edit contacts" | Ask an owner or admin to change your role or add the permission |
| You can read notes but cannot delete one | The note was written by someone else and you are not an owner or admin | Ask the author, or an owner or admin, to delete it |
| A note added through the API shows an author named after a key | That is how API notes are attributed | Name keys after the integration, for example the tool that writes the notes |
| The Client notes section says it could not load | A temporary connection problem | Select Try again |
If a note still does not appear after a reload, reply to the support thread from your workspace with the contact's name and we will look at it.