---
title: "Create a new ticket"
method: POST
path: "/ticket"
---

# Create a new ticket

`POST /ticket`

## Request body

- object
  - `description` string, required — A detailed description of the ticket.
  - `priority` string — The priority of the ticket.
  - `status` string — The current status of the ticket.
  - `assignee` string, nullable — The user Slack member ID assigned to the ticket.
  - `requester` string — The requester Slack member ID of the ticket.
  - `customFields` Field[] — Custom fields for the ticket.
    - `fieldId` string — The UUID of the custom field.
    - `value` string — The value of the custom field.
  - `requesterChannel` string, required — One of the Slack channel IDs which are assigned to form.
  - `tags` string[], nullable — Tags associated with the ticket.
  - `formId` string, required — Identifier UUID for the form used to submit the ticket. Fetched from the Web url when editing a form.

## Response `201`

Ticket successfully created

- object
  - `ticketId` string — The unique UUID of the created ticket.

## Other responses

- `400` — Invalid request payload
- `404` — Ticket not found
- `500` — Server error

---

[API](https://skmtc.net/suptask/apis/suptask-ticketing-api.md) · [All operations](https://skmtc.net/suptask/apis/suptask-ticketing-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suptask/suptask-ticketing-api/revisions/75d94953dc85/schema)