Skip to main content

Add Support Ticket Watcher

POST 
/api/support/tickets/:ticket/watchers

Adds a watcher to the ticket, who is then notified of new replies. Add a colleague by user_id, or an outside address by email (a matching user account is linked automatically if one exists).

Required scope: support:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Request body — exactly one of:

  • user_id (integer) — must belong to the same tenant
  • email (string, valid email)

Authentication: Bearer token with the support:write scope, or an authenticated session, from a user who can view the ticket. A caller whose support seat is the viewer role is refused with 403 — a viewer reads everywhere and writes nowhere, on the customer side as well as in the console. Requires the X-Tenant-Id header (or a tenant subdomain).

If this ticket was merged into another ticket, the request is refused with a 422 whose merged_into (id, number) names the live ticket — send the action there instead.

Request​

Responses​

Created

Response Headers
    Content-Type