Tickets

Add a note to a ticket

Leaves context on a ticket.

POST/api/v1/tickets/{id}/notes

A note never leaves the building — not to the customer, not to their status page, not to a GET of this ticket. Pass kind: "reply" to write to the customer instead, which emails them exactly as a reply from the desk would; it has to be asked for by name so nobody reaches it by accident.

Path parameters

Prop

Type

Request body

Prop

Type

Response 201

Prop

Type

Errors

  • 400 — Invalid body
  • 401 — Missing or invalid API key
  • 404 — Not found
  • 429 — Rate limit exceeded

Every error shares one envelope.

Example

curl -X POST \
  https://www.hey.support/api/v1/tickets/<id>/notes \
  -H 'Authorization: Bearer hs_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"body":"<body>"}'