Skip to main content
POST
Open a support ticket

Authorizations

Authorization
string
header
required

An API key (utk_live_...) or an app's OAuth access token (uto_...).

Headers

Idempotency-Key
string

Any 1 to 255 printable ASCII characters, without a space at either end. The answer to the first request with a key is kept for 24 hours per credential: the same request again gets it back (Idempotent-Replayed: true), another request with the key is 409 PUB-002-002, and while the first still runs 409 PUB-002-003. A server error is not kept, and a request that never answered frees its key after 2 minutes: a retry with the key then runs again.

Maximum string length: 255

Body

application/json
subject
string
required

At most 200 characters.

Maximum string length: 200
body
string
required

The message, at most 10,000 characters.

Maximum string length: 10000
kind
enum<string>
default:contact

The category: contact (default), setup, targeting, integrations, billing or bug.

Available options:
contact,
setup,
targeting,
integrations,
billing,
bug

Response

Created.

A ticket with a page of its thread.

id
string<uuid>
required
number
integer
required

The ticket's number, as the Help page shows it (#1042).

subject
string
required
kind
enum<string>
required

The category it was opened under.

Available options:
contact,
setup,
targeting,
integrations,
billing,
bug
status
enum<string>
required

waiting: support hasn't answered the last message; answered: support's message is the last; closed.

Available options:
waiting,
answered,
closed
messageCount
integer
required

The messages of its thread, events included.

createdAt
string<date-time>
required
Example:

"2026-09-30T10:00:00.000Z"

lastMessageAt
string<date-time> | null
required
Example:

"2026-09-30T10:00:00.000Z"

closedAt
string<date-time> | null
required
Example:

"2026-09-30T10:00:00.000Z"

url
string<uri>
required

The ticket on the Help page in Usertick, where the person reads the replies and answers them.

messages
object[]
required

A page of the thread, newest first.

nextCursor
string | null
required

Send it back as cursor for the older messages; null on the last page.

Last modified on November 15, 2026