Create a ticket type

You can create a new ticket type.

📘 Creating ticket types.

Every ticket type will be created with two default attributes: default_title and default_description. For the icon propery, use an emoji from Twemoji Cheatsheet

SecurityHTTP: bearerAuth
Request
header Parameters
Intercom-Version
string (intercom_version)
Default: 2.11

Intercom API version.
By default, it's equal to the version set in the app package.

Enum: "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" "Unstable"
Example: 2.11
Request Body schema: application/json
name
required
string

The name of the ticket type.

description
string

The description of the ticket type.

category
string

Category of the Ticket Type.

Enum: "Customer" "Back-office" "Tracker"
icon
string
Default: "🎟️"

The icon of the ticket type.

is_internal
boolean
Default: false

Whether the tickets associated with this ticket type are intended for internal use only or will be shared with customers. This is currently a limited attribute.

post
/ticket_types
Request samples
application/json
{ "name": "Customer Issue", "description": "Customer Report Template", "icon": "🎟️", "category": "Customer" }
Responses

200

Ticket type created

Response Schema: application/json
type
string

String representing the object's type. Always has the value ticket_type.

id
string

The id representing the ticket type.

category
string

Category of the Ticket Type.

Enum: "Customer" "Back-office" "Tracker"
name
string

The name of the ticket type

description
string

The description of the ticket type

icon
string

The icon of the ticket type

workspace_id
string

The id of the workspace that the ticket type belongs to.

object (Ticket Type Attributes)

A list of attributes associated with a given ticket type.

archived
boolean

Whether the ticket type is archived or not.

created_at
integer <timestamp>

The date and time the ticket type was created.

updated_at
integer <timestamp>

The date and time the ticket type was last updated.

401

Unauthorized

Response samples
application/json
{ "type": "ticket_type", "id": "225", "name": "Customer Issue", "description": "Customer Report Template", "icon": "🎟️", "workspace_id": "this_is_an_id601_that_should_be_at_least_", "archived": false, "created_at": 1716385415, "updated_at": 1716385415, "is_internal": false, "ticket_type_attributes": { "type": "list", }, "category": "Customer" }