---
title: "Service Desk - reply to or note on a ticket"
method: POST
path: "/ServiceDesk/Messages"
tags: ["Servicedesk"]
---

# Service Desk - reply to or note on a ticket

`POST /ServiceDesk/Messages`

**Requires permission:** *IT*

Posts a public reply or a note. Attributed to the acting agent, so the ticket history names a real person rather than the API key's owner. Optionally applies a status change in the same action. Requires the IT permission.

## Request body

- PostServiceDeskMessageRequest
  - `ticketId` integer
  - `kind` string, nullable
  - `body` string, nullable
  - `private` boolean
  - `emails` string[]
  - `cannedResponseId` integer, nullable
  - `status` integer, nullable
  - `category` string, nullable
  - `subCategory` string, nullable

## Response `200`

Success

- PostServiceDeskMessageResponse
  - `sent` boolean
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `400` — Empty body or unknown kind
- `401` — Unauthorized
- `403` — Missing IT permission
- `502` — Freshservice rejected the message

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/revisions/4d9bcf62aa69/schema)