Add a watcher

Adds a watcher who is notified about ticket updates

Add a watcher to a ticket

post

Adds a watcher to the specified ticket for notifications

Authorizations

AuthorizationstringRequired

Harmony access key, sent as Authorization: AccessKey <your-key>. Create keys in Settings > Access Keys. The tenant is resolved from the key.

Path parameters

ticket_idstringRequired

Body

watcher_idstring · min: 1 · max: 100 · nullableOptional

Employee to add. Exactly one of watcher_id or watcher_email.

watcher_emailstring · email · nullableOptional

Email address to add as a watcher. An address with no employee record gets a local one and follows the ticket by email, like a CC on the inbound mail; a colleague's address is a manual add.

Responses

201

Successful Response

application/json

idintegerRequired

watcher_idstringRequired

notification_reply_idstring · uuid · nullableRequired

sourcestring · enum · nullableOptional

Tracks why a watcher was added to a ticket.

Possible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

422

Validation Error

application/json

post/api/v1/tickets/{ticket_id}/watchers

POST /service-desk/api/v1/tickets/{ticket_id}/watchers HTTP/1.1
Host: api.harmony.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "watcher_id": "text",
  "watcher_email": "[e-mail]"
}

{
  "id": 1,
  "watcher_id": "text",
  "notification_reply_id": "123e4567-e89b-12d3-a456-426614174000",
  "source": "assignee",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z"
}