Skip to main content
The support ticket endpoints open, list and answer the same tickets as Help & support in Usertick. A ticket belongs to the person who opens it, so these endpoints work only for an app or an AI assistant that a member connected, and they reach only the tickets that member opened in the organization. An API key acts as the organization rather than a person, so it can’t hold these scopes, and a request with an API key returns 403 with PUB-017-002.

Open a ticket

kind takes the categories of the ticket window: contact (the default), setup, targeting, integrations, billing or bug. subject holds up to 200 characters and body up to 10,000. Usertick attaches the organization’s plan, as it does for a ticket opened in the dashboard. The call returns 201 with the ticket, its first message and its address in Location. Support answers in the order the plan gives, and its replies reach the person under Help & support and by email. If you send the request again with the same Idempotency-Key within 24 hours, it returns the same ticket. Support tickets are included in the paid plans, so on Free, opening a ticket or replying returns 403 with SUP-004-001. Each ticket appears in the activity log under the person’s name, followed by “via” and the app’s or the assistant’s name.

List and read tickets

GET /support/tickets lists the person’s tickets, the latest message first. status narrows the list to open (waiting or answered), waiting, answered or closed, and search finds a word in the subject or the first message, or a ticket’s number such as 42 or #42.
  • status is waiting while support hasn’t answered the last message, answered when support’s message is the last, and closed once the ticket is closed.
  • url opens the ticket under Help & support, where the person can read the replies and download the files support sent.
GET /support/tickets/{ticketId} returns the ticket with a page of its messages, newest first, and limit and cursor page through the older ones. Each message says whether it came from the customer or from support, and a message of kind event notes something such as support taking the ticket. A ticket another member opened returns 404 with PUB-017-001, the same as an unknown ID. Reading a ticket through the API leaves its new reply mark in Usertick as it was.

Reply on a ticket

POST /support/tickets/{ticketId}/messages takes body, up to 10,000 characters, and returns 201 with the message. A reply to a closed ticket reopens it, as it does in Usertick.
Last modified on November 15, 2026