Add a note
Add a note to a contact, account or deal.
POST https://cotlet.dev/api/v1/freshsales/notes
write Confirm
Saves the note on the record, where Freshsales shows it on the timeline for everyone who can open that record. It does not post to Slack. Nothing in Cotlet deletes a note, so check the text before you approve. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| record_type string required | string | Contact, Account or Deal. |
| record_id integer required | integer | Id of that record. |
| body string required | string | The note text. |
Request
curl -X POST https://cotlet.dev/api/v1/freshsales/notes \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"record_type":"Contact","record_id":5100231,"body":"Call 22 Oct: wants a start date before the end of November and a quote with two payment options. Next step: send the quote by Friday."}' result = client.call("freshsales", "add_note", {"record_type":"Contact","record_id":5100231,"body":"Call 22 Oct: wants a start date before the end of November and a quote with two payment options. Next step: send the quote by Friday."}) const result = await cotlet.call('freshsales', 'add_note', {"record_type":"Contact","record_id":5100231,"body":"Call 22 Oct: wants a start date before the end of November and a quote with two payment options. Next step: send the quote by Friday."}); cotlet call freshsales add_note --data '{"record_type":"Contact","record_id":5100231,"body":"Call 22 Oct: wants a start date before the end of November and a quote with two payment options. Next step: send the quote by Friday."}' Example response
{
"note_id": 9300052,
"record": {
"type": "Contact",
"id": 5100231,
"name": "Priya Nair"
},
"body": "Call 22 Oct: wants a start date before the end of November and a quote with two payment options. Next step: send the quote by Friday.",
"created_at": "2026-10-22T14:05:00"
}