Add internal note

Add a private note only agents can see.

POST https://cotlet.dev/api/v1/zendesk/tickets/{ticket_id}/internal-notes

write Confirm

Adds a private comment, shown with a yellow background and visible to agents only, never to the requester. A comment cannot be removed afterwards, so each note stays in the ticket history. It can still notify followers on the ticket. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: add_internal_note
NameTypeDescription
ticket_id integer required integer Ticket ID from search_tickets or list_view_tickets.
body string required string Note text, visible to agents only.

Request

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

Example response

JSON

{
  "ticket_id": 48230,
  "comment_id": 9120044502,
  "public": false,
  "created_at": "2026-10-16T09:01: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.