Home/Help Center/Client notes

Inbox

Client Notes on a Contact

Keep what your team knows about a customer on their contact record, see it from the Contacts page and the inbox, and add notes from your own systems with the REST API.

By Chirag Darji · Updated 26 Oct 2026 · 7 min read

On this page
  1. What a client note is for
  2. Before you start
  3. Where client notes appear
  4. Add a note from the Contacts page
  5. Note types
  6. Delete a note
  7. Client notes and internal notes
  8. Add a note from another system
  9. Troubleshooting

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:

  1. The inbox information panel. Open a conversation and look at the information panel beside the thread. Client notes are listed there.
  2. 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.
  3. The REST API. GET /api/v1/contacts/{id}/notes returns the same list, and POST to 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

  1. Open Contacts and select a contact to open their panel, or open the contact's own page.
  2. Find the Client notes section.
  3. 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

TypeUse it for
GeneralAnything the team should know
Medical / AllergyHealth details that matter before a service or an order
PrivateA label for sensitive context. It does not restrict who can read the note
Popup alertSomething 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 noteInternal note
Belongs toThe contactOne conversation
Seen inContacts, the inbox information panel, the APIThe conversation's Internal Notes tab
Survives a new conversationYesNo, a new conversation starts empty
Supports teammate mentionsNoYes

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:

FieldMeaning
idThe note's id
note_typeOne of the four types
bodyThe note text
created_at, updated_atTimestamps in UTC
authorWho wrote it: id, name and avatar_url
sourceuser 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

AnswerMeaningWhat to do
400The body is empty or longer than 5,000 characters, or the type is not one of the fourFix the request and send it again
401The key is missing, wrong or revokedSend a valid key in the Authorization header
403The key is read-onlyCreate a full-access key for integrations that write
404The contact does not exist in your workspaceCheck 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 seeLikely causeFix
The Add note button is missingYour 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 oneThe note was written by someone else and you are not an owner or adminAsk the author, or an owner or admin, to delete it
A note added through the API shows an author named after a keyThat is how API notes are attributedName keys after the integration, for example the tool that writes the notes
The Client notes section says it could not loadA temporary connection problemSelect 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.

Frequently asked questions

What is the difference between a client note and an internal note?
An internal note belongs to one conversation and sits in that conversation's Internal Notes tab. A client note belongs to the contact, so it follows the person across every conversation and shows on their record in Contacts as well as in the inbox information panel.
Can a customer see a client note?
No. Client notes are internal and are never sent in a WhatsApp message.
Who can add or delete a client note?
Anyone who can view contacts can read notes. Adding a note needs the Edit contacts permission. You can delete your own notes; owners and admins can delete any note, including notes written through the API.
What does the Private note type do?
It is a label. It does not hide the note, so every teammate who can open the contact and every API key of your workspace can read it. Do not store anything there that your whole team should not see.
Does deleting a lead delete its client notes?
No. Notes belong to the contact, so they stay when a lead is deleted.
Can I add a note from another system?
Yes. With a full-access API key, POST to /api/v1/contacts/{id}/notes with a body and an optional note_type. The note shows in the app with the key name as its author, for example the name of the key.

Run your WhatsApp on VGraple CRM

Free forever plan, official Meta WhatsApp Business API, set up in 15 minutes. No card needed.