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

Parameters: add_note
NameTypeDescription
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
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"}'
Python
result = client.call("freescout", "add_note", {"conversation_id":1,"body":"body"})
Node.js
const result = await cotlet.call('freescout', 'add_note', {"conversation_id":1,"body":"body"});
CLI
cotlet call freescout add_note --data '{"conversation_id":1,"body":"body"}'

Example response

JSON

{
  "conversation_id": 4850,
  "thread_type": "note",
  "created_at": "2026-10-23T08:12: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.