---
title: "Post Ticket"
method: POST
path: "/Tickets"
tags: ["Tickets"]
---

# Post Ticket

`POST /Tickets`

**Auth:** Authenticated - any signed-in user.

Post a ticket to the Freshservice helpdesk

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `includes` string[], nullable
- `sort` string, nullable
- `filter` string, nullable

## Request body

- PostTicketRequest
  - `ticket` Ticket
    - `subject` string, required
    - `group_id` unknown
    - `department_id` integer, nullable
    - `category` string, nullable
    - `sub_category` string, nullable
    - `item_category` unknown
    - `requester_id` integer, nullable
    - `responder_id` integer, nullable
    - `due_by` string, nullable
    - `fr_escalated` boolean
    - `deleted` boolean
    - `spam` boolean
    - `email_config_id` unknown
    - `fwd_emails` unknown[], nullable
      - unknown
    - `reply_cc_emails` string[], nullable
    - `cc_emails` string[], nullable
    - `is_escalated` boolean
    - `fr_due_by` string, nullable
    - `id` integer, nullable
    - `priority` integer, nullable
    - `status` 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11
    - `chipStatus` unknown
    - `source` integer, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `requested_for_id` integer, nullable
    - `to_emails` unknown
    - `type` string, nullable
    - `description` string, nullable
    - `description_text` string, nullable
    - `custom_fields` CustomFields
      - `major_incident_type` unknown
      - `business_impact` unknown
      - `impacted_locations` unknown
      - `no_of_customers_impacted` unknown
    - `workspace_id` integer, nullable
    - `attachments` Attachment[], nullable
      - `id` integer, nullable
      - `content_type` string, nullable
      - `size` integer, nullable
      - `name` string, nullable
      - `attachment_url` string, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `conversations` Conversation[], nullable
      - `id` integer, nullable
      - `body` string, nullable
      - `body_text` string, nullable
      - `incoming` boolean
      - `private` boolean
      - `created_at` string, date-time, nullable
      - `updated_at` string, nullable
      - `user_id` integer, nullable
      - `support_email` string, nullable
      - `source` integer, nullable
      - `ticket_id` integer, nullable
      - `to_emails` string[], nullable
      - `from_email` string, nullable
      - `cc_emails` unknown[], nullable
        - unknown
      - `bcc_emails` unknown[], nullable
        - unknown
      - `attachments` Attachment[], nullable
        - `id` integer, nullable
        - `content_type` string, nullable
        - `size` integer, nullable
        - `name` string, nullable
        - `attachment_url` string, nullable
        - `created_at` string, date-time, nullable
        - `updated_at` string, date-time, nullable
      - `requester` Requester
        - `active` boolean
        - `address` unknown
        - `background_information` unknown
        - `can_see_all_changes_from_associated_departments` boolean
        - `can_see_all_tickets_from_associated_departments` boolean
        - `created_at` string, date-time, nullable
        - `custom_fields` CustomFields
          - `major_incident_type` unknown
          - `business_impact` unknown
          - `impacted_locations` unknown
          - `no_of_customers_impacted` unknown
        - `department_ids` integer[], nullable
        - `department_names` string[], nullable
        - `external_id` string, nullable
        - `first_name` string, nullable
        - `has_logged_in` boolean
        - `id` integer
        - `is_agent` boolean
        - `job_title` string, nullable
        - `language` string, nullable
        - `last_name` string, nullable
        - `location_id` unknown
        - `location_name` unknown
        - `mobile_phone_number` unknown
        - `primary_email` string, nullable
        - `reporting_manager_id` integer, nullable
        - `secondary_emails` unknown[], nullable
          - unknown
        - `time_format` string, nullable
        - `time_zone` string, nullable
        - `updated_at` string, nullable
        - `vip_user` boolean
        - `work_phone_number` string, nullable
        - `work_schedule_id` integer, nullable
    - `responder` Agent
      - `active` boolean
      - `address` unknown
      - `auto_assign_status_changed_at` string, nullable
      - `auto_assign_tickets` boolean
      - `background_information` unknown
      - `can_see_all_tickets_from_associated_departments` boolean
      - `created_at` string, nullable
      - `custom_fields` CustomFields
        - `major_incident_type` unknown
        - `business_impact` unknown
        - `impacted_locations` unknown
        - `no_of_customers_impacted` unknown
      - `department_ids` integer[], nullable
      - `department_names` string[], nullable
      - `email` string, nullable
      - `external_id` string, nullable
      - `first_name` string, nullable
      - `has_logged_in` boolean
      - `id` integer, nullable
      - `job_title` string, nullable
      - `language` string, nullable
      - `last_active_at` string, nullable
      - `last_login_at` string, nullable
      - `last_name` string, nullable
      - `location_id` unknown
      - `location_name` unknown
      - `mobile_phone_number` unknown
      - `occasional` boolean
      - `reporting_manager_id` integer, nullable
      - `role_ids` integer[], nullable
      - `roles` Role[], nullable
        - `role_id` integer, nullable
        - `assignment_scope` string, nullable
        - `groups` unknown[], nullable
          - unknown
      - `scopes` CustomFields
        - `major_incident_type` unknown
        - `business_impact` unknown
        - `impacted_locations` unknown
        - `no_of_customers_impacted` unknown
      - `scoreboard_level_id` integer, nullable
      - `scoreboard_points` unknown
      - `signature` string, nullable
      - `time_format` string, nullable
      - `time_zone` string, nullable
      - `updated_at` string, nullable
      - `vip_user` boolean
      - `work_phone_number` string, nullable
      - `work_schedule_id` integer, nullable
      - `workspace_ids` integer[], nullable
      - `workspace_info` WorkspaceInfo[], nullable
        - `workspace_id` integer, nullable
        - `scoreboard_level_id` integer, nullable
        - `points` integer, nullable
      - `group_ids` unknown[], nullable
        - unknown
      - `member_of` unknown[], nullable
        - unknown
      - `observer_of` unknown[], nullable
        - unknown
  - `files` CoreFile[], nullable
    - `id` integer
    - `name` string
    - `contentType` string
    - `content` string, byte
    - `tags` string, nullable
    - `uploadedDate` string, date-time
    - `uploadedBy` string
    - `anyoneDownload` boolean
    - `lastModified` string, date-time
    - `size` integer, nullable
    - `viewInBrowser` string, nullable
    - `downloadInBrowser` string, nullable
    - `tempId` string, nullable

## Response `204`

Success - Success

## Other responses

- `400` — An Error Occurred - Explain Error
- `401` — Unauthorized

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/versions/fab57bf5558a/schema)