Skip to main content
POST
Create ITSM Ticket

Authorizations

X-API-KEY
string
header
required
X-CONNECTION-ID
string
header
required

Body

application/json
name
string
required

Name/Title of the Ticket

assigned_user_id
string<uuid> | null

Leen user UUID. Either assigned_user_id or assigned_user_vendor_id can be provided.

assigned_user_vendor_id
string | null

Vendor's user identifier (e.g., Jira accountId). Alternative to assigned_user_id.

comments
string | null

Public-facing comments visible to end users. ServiceNow: maps to 'comments'. Ignored for Jira.

description
string | null

Description of the Ticket

identifier
string | null

User-provided tracking identifier (auto-generated from project-type-hash if not provided)

parent_ticket_id
string<uuid> | null

Parent Ticket ID (for sub-tasks)

parent_ticket_vendor_id
string | null

Vendor's ticket identifier (e.g., Jira issue key 'PROJ-123'). Alternative to parent_ticket_id.

priority
string | null

Priority of the Ticket

project_id
string<uuid> | null

Leen project UUID. Required for vendors that use projects (e.g. Jira). Omit for vendors without projects (e.g. ServiceNow — table is derived from ticket type).

project_vendor_id
string | null

Vendor's project identifier (e.g., Jira project key 'PROJ'). Alternative to project_id. Omit for vendors without projects.

resolution_notes
string | null

Detailed explanation of resolution. ServiceNow: maps to 'close_notes'. Ignored for Jira.

resolution_reason
string | null

Category/reason for resolution. ServiceNow: maps to 'close_code'. Ignored for Jira.

status
string | null

Status of the Ticket. Note: Jira does not support setting status at creation time — tickets are always created with the workflow's default status. Use the update endpoint to change status after creation.

status_change_reason
string | null

Reason for a status change (e.g. reason for putting on hold). ServiceNow: maps to 'hold_reason'. Ignored for Jira.

type
string | null

Type of the Ticket (e.g., Task, Bug, Story)

type_id
string | null
deprecated

Deprecated: use type_vendor_id instead. Vendor issue type ID.

type_vendor_id
string | null

Vendor issue type ID (e.g., Jira issue type ID). Alternative to type — at least one must be provided. Preferred over type when both are given.

work_notes
string | null

Internal work notes visible only to agents. ServiceNow: maps to 'work_notes'. Ignored for Jira.

Response

Successful Response

Response model for ticket creation. Extends ScopedITSMTicketRespModel with vendor ID fields that are echoed back when vendor IDs were provided in the request (rather than Leen UUIDs).

id
string<uuid>
required

Leen's UUID for the Ticket

name
string
required

Name of the Ticket

status
string
required

Status of the Ticket

vendor_attributes
ITSM Ticket Vendor Attributes · object
required

Vendor-specific attributes of the Ticket

active
boolean | null

Whether the Ticket is active

assigned_user_id
string<uuid> | null

User ID assigned to the Ticket

assigned_user_vendor_id
string | null

Vendor account ID of the assigned user (e.g. Jira accountId). Populated when the request used assigned_user_vendor_id.

closed_at
string<date-time> | null

Closing time of the Ticket

created_by_user_id
string<uuid> | null

User ID who created the Ticket

description
string | null

Description of the Ticket

due_date
string<date-time> | null

Due date of the Ticket

identifier
string | null

User-provided tracking identifier for the Ticket

parent_ticket_id
string<uuid> | null

Parent Ticket ID (for sub-tasks)

parent_ticket_vendor_id
string | null

Vendor key of the parent ticket (e.g. 'PROJ-42'). Populated when the request used parent_ticket_vendor_id.

priority
string | null

Priority of the Ticket

project_id
string<uuid> | null

Project ID the Ticket belongs to

status_updated_at
string<date-time> | null

Last status update time

tags
string[] | null

Tags associated with the Ticket

ticket_created_at
string<date-time> | null

Creation time of the Ticket in the vendor system

type
string | null

Type of the Ticket (e.g., Epic, Story, Task, Bug)

type_id
string | null

Vendor-specific type ID (e.g., Jira issue type ID)

type_vendor_id
string | null

Vendor issue type ID (e.g. '10034'). Populated when the request used type_vendor_id.

url
string | null

URL of the Ticket