Send a message from a record
Email an agent, a user or a group from inside a service record.
POST https://cotlet.dev/api/v1/sysaid/records/{record_id}/messages
write Confirm
Sends an email notification from the record and returns the recipients. The message is logged on the record. An email cannot be recalled once sent. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| record_id integer required | integer | Service record ID from search_service_records. IDs are unique across incidents, requests, problems and changes. |
| to string[] required | string[] | IDs of users and groups, "u" before a user ID and "g" before a group ID, for example u2342 or g332. |
| subject string required | string | Subject line. |
| body string required | string | Message text. |
| cc string[] | string[] | IDs to copy, in the same format as to. |
Request
curl -X POST https://cotlet.dev/api/v1/sysaid/records/1/messages \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to":["to"],"subject":"subject","body":"body"}'result = client.call("sysaid", "send_message", {"record_id":1,"to":["to"],"subject":"subject","body":"body"})const result = await cotlet.call('sysaid', 'send_message', {"record_id":1,"to":["to"],"subject":"subject","body":"body"});cotlet call sysaid send_message --data '{"record_id":1,"to":["to"],"subject":"subject","body":"body"}'Example response
{
"record_id": 48230,
"sent_to": [
"u2342"
],
"cc": [],
"subject": "Update on your VPN ticket",
"sent_at": "2026-10-23T08:45:00Z"
}