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.
statusiswaitingwhile support hasn’t answered the last message,answeredwhen support’s message is the last, andclosedonce the ticket is closed.urlopens 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.