Add internal note
Add an internal note to a conversation. The customer does not see it.
POST https://cotlet.dev/api/v1/freescout/conversations/{conversation_id}/notes
write Confirm
Adds a note under your name, the same as Add Note in the conversation. Notes are for your team and are not sent to the customer. A note cannot be removed with one call from Cotlet, so keep it short. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id integer required | integer | Conversation ID from list_conversations or get_conversation. It is not the #number shown in the list. |
| body string required | string | Text of the note. |
Request
curl -X POST https://cotlet.dev/api/v1/freescout/conversations/1/notes \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"body"}' result = client.call("freescout", "add_note", {"conversation_id":1,"body":"body"}) const result = await cotlet.call('freescout', 'add_note', {"conversation_id":1,"body":"body"}); cotlet call freescout add_note --data '{"conversation_id":1,"body":"body"}' Example response
{
"conversation_id": 4850,
"thread_type": "note",
"created_at": "2026-10-23T08:12:00Z"
}