POST
Create ticket
/ticketsCreates a new ticket on a board.
Common Use Cases
- Create tickets from external forms or applications
- Automate ticket creation from email or chat
- Import tickets from other systems
Important Notes
- The board_id must be a valid board in your organization
- Labels are optional and will be created if they don't exist
Request Body
application/jsonrequired
{
board_id*:stringID of the board to create the ticket in
title*:stringTicket title
description:stringTicket description
status_id:stringStatus/column ID. Defaults to first column.
priority:"low" | "medium" | "high" | "critical"Default: "medium"
lowmediumhighcritical
assignee_id:stringUser ID of assignee
due_date:string (date-time)Due date
labels:string[]List of labels
custom_fields:objectCustom field values
}
Code Examples
curl -X POST "https://api.qamaq.io/api/v1/tickets" \
-H "Authorization: Bearer qmq_your_api_key" \
-H "Content-Type: application/json" \
-d '{"key": "value"}'Responses
201Ticket created successfully
Response Body
{
id:stringboard_id:stringtitle:stringdescription:stringstatus_id:stringstatus_name:stringpriority:"low" | "medium" | "high" | "critical"lowmediumhighcritical
assignee_id:stringassignee_name:stringdue_date:string (date-time)labels:string[]custom_fields:objectposition:integercreated_at:string (date-time)updated_at:string (date-time)created_by:string}