---
title: "Create a new support ticket"
method: POST
path: "/tickets"
tags: ["Support"]
---

# Create a new support ticket

`POST /tickets`

## Request body

- object
  - `subject` string, required — A title of the ticket.
  - `description` string, required — The description body of the support ticket.
  - `requester_id` string, uuid — UUID of the ticket requester. Converted from the ZID value.
  - `priority` 'low' | 'normal' | 'high' | 'urgent' — A priority of the ticket.
  - `subscription_id` string — see create()
  - `organization_id` string — see create()
  - `affected_url` string, url — see create().
  - `followup_tid` string — The unique ID of the ticket which this ticket is a follow-up to.
  - `category` 'access' | 'billing_question' | 'complaint' | 'compliance_question' | 'configuration_change' | 'general_question' | 'incident_outage' | 'bug_report' | 'report_a_gui_bug' | 'onboarding' | 'close_my_account' — The category of the support ticket.
  - `attachments` object[] — A list of attachments for the ticket.
    - `filename` string — The filename to be used in storage.
    - `data` string — the base64 encoded file.
  - `collaborator_ids` string[] — A list of collaborators uuids for the ticket.

## Response `200`

A Support Ticket object

- Ticket — The support ticket object.
  - `ticket_id` integer — The ID of the ticket.
  - `created` string, date-time — The time when the support ticket was created.
  - `updated` string, date-time — The time when the support ticket was updated.
  - `type` 'problem' | 'task' | 'incident' | 'question' — A type of the ticket.
  - `subject` string — A title of the ticket.
  - `description` string — The description body of the support ticket.
  - `priority` 'low' | 'normal' | 'high' | 'urgent' — A priority of the ticket.
  - `followup_tid` string — Followup ticket ID. The unique ID of the ticket which this ticket is a follow-up to.
  - `status` 'closed' | 'deleted' | 'hold' | 'new' | 'open' | 'pending' | 'solved' — The status of the support ticket.
  - `recipient` string — Email address of the ticket recipient, defaults to support@upsun.com.
  - `requester_id` string, uuid — UUID of the ticket requester.
  - `submitter_id` string, uuid — UUID of the ticket submitter.
  - `assignee_id` string, uuid — UUID of the ticket assignee.
  - `organization_id` string — A reference id that is usable to find the commerce license.
  - `collaborator_ids` string[] — A list of the collaborators uuids for this ticket.
  - `has_incidents` boolean — Whether or not this ticket has incidents.
  - `due` string, date-time — A time that the ticket is due at.
  - `tags` string[] — A list of tags assigned to the ticket.
  - `subscription_id` string — The internal ID of the subscription.
  - `ticket_group` string — Maps to zendesk field 'Request group'.
  - `support_plan` string — Maps to zendesk field 'The support plan associated with this ticket.
  - `affected_url` string, url — The affected URL associated with the support ticket.
  - `queue` string — The queue the support ticket is in.
  - `issue_type` string — The issue type of the support ticket.
  - `resolution_time` string, date-time — Maps to zendesk field 'Resolution Time'.
  - `response_time` string, date-time — Maps to zendesk field 'Response Time (time from request to reply).
  - `project_url` string, url — Maps to zendesk field 'Project URL'.
  - `region` string — Maps to zendesk field 'Region'.
  - `category` 'access' | 'billing_question' | 'complaint' | 'compliance_question' | 'configuration_change' | 'general_question' | 'incident_outage' | 'bug_report' | 'onboarding' | 'report_a_gui_bug' | 'close_my_account' — Maps to zendesk field 'Category'.
  - `environment` 'env_development' | 'env_staging' | 'env_production' — Maps to zendesk field 'Environment'.
  - `ticket_sharing_status` 'ts_sent_to_platform' | 'ts_accepted_by_platform' | 'ts_returned_from_platform' | 'ts_solved_by_platform' | 'ts_rejected_by_platform' — Maps to zendesk field 'Ticket Sharing Status'.
  - `application_ticket_url` string, url — Maps to zendesk field 'Application Ticket URL'.
  - `infrastructure_ticket_url` string, url — Maps to zendesk field 'Infrastructure Ticket URL'.
  - `jira` object[] — A list of JIRA issues related to the support ticket.
    - `id` integer — The id of the query.
    - `ticket_id` integer — The id of the ticket.
    - `issue_id` integer — The issue id number.
    - `issue_key` string — The issue key.
    - `created_at` number, float — The created at timestamp.
    - `updated_at` number, float — The updated at timestamp.
  - `zd_ticket_url` string, url — URL to the customer-facing ticket in Zendesk.

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)