Add internal note
Write a note on a ticket that the customer cannot see.
POST https://cotlet.dev/api/v1/zammad/tickets/{ticket_id}/internal-notes
write Confirm
Adds a note article with internal visibility and returns it. Colleagues see it in the ticket, and a mention such as @Nora Weiss in the body notifies that agent. The customer sees nothing and no email goes out. Zammad lets only the author delete an article, and only within 10 minutes, and Cotlet has no delete, so each note waits for you. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| ticket_id integer required | integer | Ticket ID from search_tickets, list_overview_tickets or the ticket address (#ticket/zoom/{ticket_id}). |
| body string required | string | Note text. |
Request
curl -X POST https://cotlet.dev/api/v1/zammad/tickets/1/internal-notes \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"body"}'result = client.call("zammad", "add_internal_note", {"ticket_id":1,"body":"body"})const result = await cotlet.call('zammad', 'add_internal_note', {"ticket_id":1,"body":"body"});cotlet call zammad add_internal_note --data '{"ticket_id":1,"body":"body"}'Example response
{
"article_id": 9071,
"ticket_id": 4812,
"type": "note",
"internal": true,
"created_at": "2026-10-22T08:04:00.000Z"
}