Add internal note
Add a note only people in your organization can see.
POST https://cotlet.dev/api/v1/kustomer/conversations/{conversation_id}/notes
write Confirm
Adds an internal note to the conversation, visible only to users in your organization and never sent to the customer. A note holds at most 10,240 characters. Mention a user or team with @ and the name: each mention is notified, up to 20 per note, which is why this call asks first. A note can be edited or deleted in Kustomer afterwards. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id string required | string | Conversation ID from search_conversations. |
| body string required | string | Note text, visible inside your organization only. |
Request
curl -X POST https://cotlet.dev/api/v1/kustomer/conversations/6718d2e4a1b2c3d4e5f60711/notes \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"Handoff: CSV export errors since 12 Oct. Cache cleared and app reinstalled, no change. Customer expects a fix by Friday."}'result = client.call("kustomer", "add_note", {"conversation_id":"6718d2e4a1b2c3d4e5f60711","body":"Handoff: CSV export errors since 12 Oct. Cache cleared and app reinstalled, no change. Customer expects a fix by Friday."})const result = await cotlet.call('kustomer', 'add_note', {"conversation_id":"6718d2e4a1b2c3d4e5f60711","body":"Handoff: CSV export errors since 12 Oct. Cache cleared and app reinstalled, no change. Customer expects a fix by Friday."});cotlet call kustomer add_note --data '{"conversation_id":"6718d2e4a1b2c3d4e5f60711","body":"Handoff: CSV export errors since 12 Oct. Cache cleared and app reinstalled, no change. Customer expects a fix by Friday."}'Example response
{
"conversation_id": "6718d2e4a1b2c3d4e5f60711",
"note_id": "6720b1d0a1b2c3d4e5f60855",
"internal": true,
"created_at": "2026-10-17T09:01:00Z"
}