Add private note

Add a private note that only your team sees.

POST https://cotlet.dev/api/v1/chatwoot/conversations/{conversation_id}/private-notes

write Confirm

Adds a note to the conversation that the customer is never notified about; your teammates see it in the thread. A note cannot be removed through Cotlet. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: add_private_note
NameTypeDescription
conversation_id integer required integer conversation_id from list_conversations. It is the number in the conversation URL.
body string required string Note text.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/chatwoot/conversations/1/private-notes \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body":"body"}'
Python
result = client.call("chatwoot", "add_private_note", {"conversation_id":1,"body":"body"})
Node.js
const result = await cotlet.call('chatwoot', 'add_private_note', {"conversation_id":1,"body":"body"});
CLI
cotlet call chatwoot add_private_note --data '{"conversation_id":1,"body":"body"}'

Example response

JSON

{
  "message_id": 90413,
  "conversation_id": 1842,
  "private": true,
  "created_at": "2026-10-22T07:21:00Z"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.