---
title: "Enqueue create ticket"
method: POST
path: "/tickets/enqueue"
tags: ["Tickets"]
---

# Enqueue create ticket

`POST /tickets/enqueue`

Enqueues ticket creation for asynchronous processing, returning if the job was enqueued successfully to be processed. We attempt to perform a best-effort validation on inputs before tasks are enqueued. If the given parameters are incorrect, we won't enqueue the job.

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Request body

- CreateTicketRequest — You can create a Ticket
  - `ticket_type_id` string, required — The ID of the type of ticket you want to create
  - `contacts` union[], required — The list of contacts (users or leads) affected by this ticket. Currently only one is allowed
    - union
      - object
        - `id` string, required — The identifier for the contact as given by Intercom.
      - object
        - `external_id` string, required — The external_id you have defined for the contact who is being added as a participant.
      - object
        - `email` string, required — The email you have defined for the contact who is being added as a participant. If a contact with this email does not exist, one will be created.
  - `conversation_to_link_id` string — The ID of the conversation you want to link to the ticket. Here are the valid ways of linking two tickets: - conversation | back-office ticket - customer tickets | non-shared back-office ticket - conversation | tracker ticket - customer ticket | tracker ticket
  - `company_id` string — The ID of the company that the ticket is associated with. The unique identifier for the company which is given by Intercom
  - `created_at` integer — The time the ticket was created. If not provided, the current time will be used.
  - `ticket_attributes` TicketRequestCustomAttributes — The attributes set on the ticket. When setting the default title and description attributes, the attribute keys that should be used are `_default_title_` and `_default_description_`. When setting ticket type attributes of the list attribute type, the key should be the attribute name and the value of the attribute should be the list item id, obtainable by [listing the ticket type](ref:get_ticket-types). For example, if the ticket type has an attribute called `priority` of type `list`, the key should be `priority` and the value of the attribute should be the guid of the list item (e.g. `de1825a0-0164-4070-8ca6-13e22462fa7e`).
  - `assignment` object
    - `admin_assignee_id` string — The ID of the admin to which the ticket is assigned. If not provided, the ticket will be unassigned.
    - `team_assignee_id` string — The ID of the team to which the ticket is assigned. If not provided, the ticket will be unassigned.

## Response `200`

Successful response

- Jobs — Jobs are tasks that are processed asynchronously by the Intercom system after being enqueued via the API. This allows for efficient handling of operations that may take time to complete, such as data imports or exports. You can check the status of your jobs to monitor their progress and ensure they are completed successfully.
  - `type` 'job' — The type of the object
  - `id` string, required — The id of the job that's currently being processed or has completed.
  - `url` string — API endpoint URL to check the job status.
  - `status` 'pending' | 'success' | 'failed' — The status of the job execution.
  - `resource_type` string — The type of resource created during job execution.
  - `resource_id` string, nullable — The id of the resource created during job execution (e.g. ticket id)
  - `resource_url` string, nullable — The url of the resource created during job exeuction. Use this url to fetch the resource.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

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