POST/tickets

Create a ticket

Open a ticket as a team API key. Requires a team-role API key.

Request body

Field	Type	Description
`type`	`"customer" \| "back_office" \| "tracker"`	Ticket object type
`ticketTypeId`	`string`	Registry ticket-type ID — its category becomes the ticket type
`title`required	`string`
`description`	`string`	Opening message as markdown
`priority`	`"none" \| "low" \| "medium" \| "high" \| "urgent"`
`requesterPrincipalId`	`string`	Requester principal ID
`companyId`	`string`	Associated company ID
`attachments`	`object[]`

Response

Ticket created

Field	Type	Description
`id`required	`string`	TypeID - a type-prefixed UUID
`number`required	`number`	Per-workspace sequential ticket number
`reference`required	`string`	Human reference, "#" + number
`type`required	`"customer" \| "back_office" \| "tracker"`	Ticket object type
`ticketType`required	`object \| null`	Workspace-defined registry type, null on legacy typeless tickets
`title`required	`string`
`status`required	`object`	Internal workspace status: its display name + stable category
`stage`required	`"received" \| "in_progress" \| "awaiting_requester" \| "resolved" \| null`	Customer-facing public stage, null when the status projects none
`priority`required	`"none" \| "low" \| "medium" \| "high" \| "urgent"`	Triage priority
`requesterPrincipalId`required	`string \| null`	Principal ID of the requester, null if unattributed
`assigneePrincipalId`required	`string \| null`	Principal ID of the assigned teammate, null if unassigned
`assigneeTeamId`required	`string \| null`	ID of the assigned team, null if unassigned
`companyId`required	`string \| null`	ID of the associated company, null if none
`firstResponseAt`required	`string \| null`	When a teammate first responded, null until then
`dueAt`required	`string \| null`	SLA due time, null if no policy applies
`resolvedAt`required	`string \| null`	When the ticket entered a closed status, null while open
`createdAt`required	`string`	ISO 8601 timestamp
`updatedAt`required	`string`	ISO 8601 timestamp
`reopenedCount`required	`number`	How many times the ticket has reopened

Errors

400Validation error

401Unauthorized

Example request

curl \
  -X POST \
  "https://feedback.quackback.io/api/v1/tickets" \
  -H "Authorization: Bearer qb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "customer",
  "ticketTypeId": "ticket_type_01h455vb4pex5vsknk084sn02q",
  "title": "Cannot log in",
  "description": "Steps to reproduce…",
  "priority": "high",
  "requesterPrincipalId": "example_requesterPrincipalId",
  "companyId": "example_companyId",
  "attachments": []
}'