Create ticket

Create ticket

curl --request POST \
  --url https://api.helpdesk.com/v1/tickets \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lastMessageAt": "2026-06-30T22:02:08.901Z",
  "parentTicket": {
    "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
    "shortID": "IIPZGJ",
    "subject": "Parent ticket subject"
  },
  "childTickets": [
    {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "shortID": "IIPZGJ",
      "subject": "Child ticket subject"
    }
  ],
  "status": "open",
  "priority": -10,
  "subject": "Ticket subject",
  "teamIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "requester": {
    "email": "requester@email.com",
    "name": "John Client"
  },
  "cc": [
    {
      "email": "cc@email.com",
      "name": "John Client"
    }
  ],
  "tagIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "followers": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "assignment": {
    "team": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c"
    },
    "agent": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c"
    }
  },
  "integration": {
    "type": "livechat",
    "referenceType": "",
    "referenceURL": "",
    "referenceID": ""
  },
  "customFields": {
    "order-id": "1234"
  },
  "author": {
    "type": "client"
  },
  "message": {
    "text": "Hello from a ticket!",
    "cannedResponseIDs": [
      "42e113f9-9353-4e89-9f68-69b92f423b0c"
    ]
  },
  "isPrivate": true,
  "transactionID": "050340e4-82de-4a2a-a1c4-724dfaf66cec"
}
'

import requests

url = "https://api.helpdesk.com/v1/tickets"

payload = {
    "lastMessageAt": "2026-06-30T22:02:08.901Z",
    "parentTicket": {
        "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
        "shortID": "IIPZGJ",
        "subject": "Parent ticket subject"
    },
    "childTickets": [
        {
            "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
            "shortID": "IIPZGJ",
            "subject": "Child ticket subject"
        }
    ],
    "status": "open",
    "priority": -10,
    "subject": "Ticket subject",
    "teamIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "requester": {
        "email": "requester@email.com",
        "name": "John Client"
    },
    "cc": [
        {
            "email": "cc@email.com",
            "name": "John Client"
        }
    ],
    "tagIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "followers": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "assignment": {
        "team": { "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c" },
        "agent": { "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c" }
    },
    "integration": {
        "type": "livechat",
        "referenceType": "",
        "referenceURL": "",
        "referenceID": ""
    },
    "customFields": { "order-id": "1234" },
    "author": { "type": "client" },
    "message": {
        "text": "Hello from a ticket!",
        "cannedResponseIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"]
    },
    "isPrivate": True,
    "transactionID": "050340e4-82de-4a2a-a1c4-724dfaf66cec"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    lastMessageAt: '2026-06-30T22:02:08.901Z',
    parentTicket: {
      ID: '42e113f9-9353-4e89-9f68-69b92f423b0c',
      shortID: 'IIPZGJ',
      subject: 'Parent ticket subject'
    },
    childTickets: [
      {
        ID: '42e113f9-9353-4e89-9f68-69b92f423b0c',
        shortID: 'IIPZGJ',
        subject: 'Child ticket subject'
      }
    ],
    status: 'open',
    priority: -10,
    subject: 'Ticket subject',
    teamIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    requester: {email: 'requester@email.com', name: 'John Client'},
    cc: [{email: 'cc@email.com', name: 'John Client'}],
    tagIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    followers: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    assignment: {
      team: {ID: '42e113f9-9353-4e89-9f68-69b92f423b0c'},
      agent: {ID: '42e113f9-9353-4e89-9f68-69b92f423b0c'}
    },
    integration: {type: 'livechat', referenceType: '', referenceURL: '', referenceID: ''},
    customFields: {'order-id': '1234'},
    author: {type: 'client'},
    message: {
      text: 'Hello from a ticket!',
      cannedResponseIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c']
    },
    isPrivate: true,
    transactionID: '050340e4-82de-4a2a-a1c4-724dfaf66cec'
  })
};

fetch('https://api.helpdesk.com/v1/tickets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.helpdesk.com/v1/tickets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'lastMessageAt' => '2026-06-30T22:02:08.901Z',
    'parentTicket' => [
        'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c',
        'shortID' => 'IIPZGJ',
        'subject' => 'Parent ticket subject'
    ],
    'childTickets' => [
        [
                'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c',
                'shortID' => 'IIPZGJ',
                'subject' => 'Child ticket subject'
        ]
    ],
    'status' => 'open',
    'priority' => -10,
    'subject' => 'Ticket subject',
    'teamIDs' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'requester' => [
        'email' => 'requester@email.com',
        'name' => 'John Client'
    ],
    'cc' => [
        [
                'email' => 'cc@email.com',
                'name' => 'John Client'
        ]
    ],
    'tagIDs' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'followers' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'assignment' => [
        'team' => [
                'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ],
        'agent' => [
                'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ]
    ],
    'integration' => [
        'type' => 'livechat',
        'referenceType' => '',
        'referenceURL' => '',
        'referenceID' => ''
    ],
    'customFields' => [
        'order-id' => '1234'
    ],
    'author' => [
        'type' => 'client'
    ],
    'message' => [
        'text' => 'Hello from a ticket!',
        'cannedResponseIDs' => [
                '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ]
    ],
    'isPrivate' => true,
    'transactionID' => '050340e4-82de-4a2a-a1c4-724dfaf66cec'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.helpdesk.com/v1/tickets"

	payload := strings.NewReader("{\n  \"lastMessageAt\": \"2026-06-30T22:02:08.901Z\",\n  \"parentTicket\": {\n    \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n    \"shortID\": \"IIPZGJ\",\n    \"subject\": \"Parent ticket subject\"\n  },\n  \"childTickets\": [\n    {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n      \"shortID\": \"IIPZGJ\",\n      \"subject\": \"Child ticket subject\"\n    }\n  ],\n  \"status\": \"open\",\n  \"priority\": -10,\n  \"subject\": \"Ticket subject\",\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"integration\": {\n    \"type\": \"livechat\",\n    \"referenceType\": \"\",\n    \"referenceURL\": \"\",\n    \"referenceID\": \"\"\n  },\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.helpdesk.com/v1/tickets")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"lastMessageAt\": \"2026-06-30T22:02:08.901Z\",\n  \"parentTicket\": {\n    \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n    \"shortID\": \"IIPZGJ\",\n    \"subject\": \"Parent ticket subject\"\n  },\n  \"childTickets\": [\n    {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n      \"shortID\": \"IIPZGJ\",\n      \"subject\": \"Child ticket subject\"\n    }\n  ],\n  \"status\": \"open\",\n  \"priority\": -10,\n  \"subject\": \"Ticket subject\",\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"integration\": {\n    \"type\": \"livechat\",\n    \"referenceType\": \"\",\n    \"referenceURL\": \"\",\n    \"referenceID\": \"\"\n  },\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.helpdesk.com/v1/tickets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"lastMessageAt\": \"2026-06-30T22:02:08.901Z\",\n  \"parentTicket\": {\n    \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n    \"shortID\": \"IIPZGJ\",\n    \"subject\": \"Parent ticket subject\"\n  },\n  \"childTickets\": [\n    {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n      \"shortID\": \"IIPZGJ\",\n      \"subject\": \"Child ticket subject\"\n    }\n  ],\n  \"status\": \"open\",\n  \"priority\": -10,\n  \"subject\": \"Ticket subject\",\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"integration\": {\n    \"type\": \"livechat\",\n    \"referenceType\": \"\",\n    \"referenceURL\": \"\",\n    \"referenceID\": \"\"\n  },\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\"\n}"

response = http.request(request)
puts response.read_body

{
  "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
  "licenseID": 13381337,
  "createdAt": "2026-06-30T22:02:08.901Z",
  "createdBy": "f56caf69-3f05-4386-9567-fdc909d7ad77",
  "createdByType": "agent",
  "updatedAt": "2026-06-30T22:02:08.901Z",
  "updatedBy": "f56caf69-3f05-4386-9567-fdc909d7ad77",
  "shortID": "IIPZGJ",
  "lastMessageAt": "2026-06-30T22:02:08.901Z",
  "parentTicket": {
    "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
    "shortID": "IIPZGJ",
    "subject": "Parent ticket subject"
  },
  "childTickets": [
    {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "shortID": "IIPZGJ",
      "subject": "Child ticket subject"
    }
  ],
  "status": "open",
  "priority": -10,
  "subject": "Ticket subject",
  "teamIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "requester": {
    "email": "",
    "name": ""
  },
  "cc": [
    {
      "email": "cc@email.com",
      "name": "John Client"
    }
  ],
  "tagIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "followers": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "assignment": {
    "team": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "name": ""
    },
    "agent": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "name": ""
    }
  },
  "integration": {
    "type": "livechat",
    "referenceType": "",
    "referenceURL": "",
    "referenceID": ""
  },
  "customFields": {
    "order-id": "1234"
  },
  "ratingRequeestSent": true,
  "rating": {
    "rate": "good",
    "comment": "",
    "requestedAt": "2026-06-30T22:02:08.901Z"
  },
  "silo": "tickets",
  "spam": {
    "status": true,
    "reason": "licenseBlackList"
  },
  "source": {
    "type": "api"
  },
  "events": [
    {
      "type": "message"
    }
  ],
  "integrations": {
    "type": "livechat",
    "externalID": ""
  },
  "detectedLanguage": ""
}

POST

tickets

Create ticket

curl --request POST \
  --url https://api.helpdesk.com/v1/tickets \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lastMessageAt": "2026-06-30T22:02:08.901Z",
  "parentTicket": {
    "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
    "shortID": "IIPZGJ",
    "subject": "Parent ticket subject"
  },
  "childTickets": [
    {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "shortID": "IIPZGJ",
      "subject": "Child ticket subject"
    }
  ],
  "status": "open",
  "priority": -10,
  "subject": "Ticket subject",
  "teamIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "requester": {
    "email": "requester@email.com",
    "name": "John Client"
  },
  "cc": [
    {
      "email": "cc@email.com",
      "name": "John Client"
    }
  ],
  "tagIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "followers": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "assignment": {
    "team": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c"
    },
    "agent": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c"
    }
  },
  "integration": {
    "type": "livechat",
    "referenceType": "",
    "referenceURL": "",
    "referenceID": ""
  },
  "customFields": {
    "order-id": "1234"
  },
  "author": {
    "type": "client"
  },
  "message": {
    "text": "Hello from a ticket!",
    "cannedResponseIDs": [
      "42e113f9-9353-4e89-9f68-69b92f423b0c"
    ]
  },
  "isPrivate": true,
  "transactionID": "050340e4-82de-4a2a-a1c4-724dfaf66cec"
}
'

import requests

url = "https://api.helpdesk.com/v1/tickets"

payload = {
    "lastMessageAt": "2026-06-30T22:02:08.901Z",
    "parentTicket": {
        "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
        "shortID": "IIPZGJ",
        "subject": "Parent ticket subject"
    },
    "childTickets": [
        {
            "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
            "shortID": "IIPZGJ",
            "subject": "Child ticket subject"
        }
    ],
    "status": "open",
    "priority": -10,
    "subject": "Ticket subject",
    "teamIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "requester": {
        "email": "requester@email.com",
        "name": "John Client"
    },
    "cc": [
        {
            "email": "cc@email.com",
            "name": "John Client"
        }
    ],
    "tagIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "followers": ["42e113f9-9353-4e89-9f68-69b92f423b0c"],
    "assignment": {
        "team": { "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c" },
        "agent": { "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c" }
    },
    "integration": {
        "type": "livechat",
        "referenceType": "",
        "referenceURL": "",
        "referenceID": ""
    },
    "customFields": { "order-id": "1234" },
    "author": { "type": "client" },
    "message": {
        "text": "Hello from a ticket!",
        "cannedResponseIDs": ["42e113f9-9353-4e89-9f68-69b92f423b0c"]
    },
    "isPrivate": True,
    "transactionID": "050340e4-82de-4a2a-a1c4-724dfaf66cec"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    lastMessageAt: '2026-06-30T22:02:08.901Z',
    parentTicket: {
      ID: '42e113f9-9353-4e89-9f68-69b92f423b0c',
      shortID: 'IIPZGJ',
      subject: 'Parent ticket subject'
    },
    childTickets: [
      {
        ID: '42e113f9-9353-4e89-9f68-69b92f423b0c',
        shortID: 'IIPZGJ',
        subject: 'Child ticket subject'
      }
    ],
    status: 'open',
    priority: -10,
    subject: 'Ticket subject',
    teamIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    requester: {email: 'requester@email.com', name: 'John Client'},
    cc: [{email: 'cc@email.com', name: 'John Client'}],
    tagIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    followers: ['42e113f9-9353-4e89-9f68-69b92f423b0c'],
    assignment: {
      team: {ID: '42e113f9-9353-4e89-9f68-69b92f423b0c'},
      agent: {ID: '42e113f9-9353-4e89-9f68-69b92f423b0c'}
    },
    integration: {type: 'livechat', referenceType: '', referenceURL: '', referenceID: ''},
    customFields: {'order-id': '1234'},
    author: {type: 'client'},
    message: {
      text: 'Hello from a ticket!',
      cannedResponseIDs: ['42e113f9-9353-4e89-9f68-69b92f423b0c']
    },
    isPrivate: true,
    transactionID: '050340e4-82de-4a2a-a1c4-724dfaf66cec'
  })
};

fetch('https://api.helpdesk.com/v1/tickets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.helpdesk.com/v1/tickets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'lastMessageAt' => '2026-06-30T22:02:08.901Z',
    'parentTicket' => [
        'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c',
        'shortID' => 'IIPZGJ',
        'subject' => 'Parent ticket subject'
    ],
    'childTickets' => [
        [
                'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c',
                'shortID' => 'IIPZGJ',
                'subject' => 'Child ticket subject'
        ]
    ],
    'status' => 'open',
    'priority' => -10,
    'subject' => 'Ticket subject',
    'teamIDs' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'requester' => [
        'email' => 'requester@email.com',
        'name' => 'John Client'
    ],
    'cc' => [
        [
                'email' => 'cc@email.com',
                'name' => 'John Client'
        ]
    ],
    'tagIDs' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'followers' => [
        '42e113f9-9353-4e89-9f68-69b92f423b0c'
    ],
    'assignment' => [
        'team' => [
                'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ],
        'agent' => [
                'ID' => '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ]
    ],
    'integration' => [
        'type' => 'livechat',
        'referenceType' => '',
        'referenceURL' => '',
        'referenceID' => ''
    ],
    'customFields' => [
        'order-id' => '1234'
    ],
    'author' => [
        'type' => 'client'
    ],
    'message' => [
        'text' => 'Hello from a ticket!',
        'cannedResponseIDs' => [
                '42e113f9-9353-4e89-9f68-69b92f423b0c'
        ]
    ],
    'isPrivate' => true,
    'transactionID' => '050340e4-82de-4a2a-a1c4-724dfaf66cec'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.helpdesk.com/v1/tickets"

	payload := strings.NewReader("{\n  \"lastMessageAt\": \"2026-06-30T22:02:08.901Z\",\n  \"parentTicket\": {\n    \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n    \"shortID\": \"IIPZGJ\",\n    \"subject\": \"Parent ticket subject\"\n  },\n  \"childTickets\": [\n    {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n      \"shortID\": \"IIPZGJ\",\n      \"subject\": \"Child ticket subject\"\n    }\n  ],\n  \"status\": \"open\",\n  \"priority\": -10,\n  \"subject\": \"Ticket subject\",\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"integration\": {\n    \"type\": \"livechat\",\n    \"referenceType\": \"\",\n    \"referenceURL\": \"\",\n    \"referenceID\": \"\"\n  },\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.helpdesk.com/v1/tickets")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"lastMessageAt\": \"2026-06-30T22:02:08.901Z\",\n  \"parentTicket\": {\n    \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n    \"shortID\": \"IIPZGJ\",\n    \"subject\": \"Parent ticket subject\"\n  },\n  \"childTickets\": [\n    {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n      \"shortID\": \"IIPZGJ\",\n      \"subject\": \"Child ticket subject\"\n    }\n  ],\n  \"status\": \"open\",\n  \"priority\": -10,\n  \"subject\": \"Ticket subject\",\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"integration\": {\n    \"type\": \"livechat\",\n    \"referenceType\": \"\",\n    \"referenceURL\": \"\",\n    \"referenceID\": \"\"\n  },\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.helpdesk.com/v1/tickets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"lastMessageAt\": \"2026-06-30T22:02:08.901Z\",\n  \"parentTicket\": {\n    \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n    \"shortID\": \"IIPZGJ\",\n    \"subject\": \"Parent ticket subject\"\n  },\n  \"childTickets\": [\n    {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\",\n      \"shortID\": \"IIPZGJ\",\n      \"subject\": \"Child ticket subject\"\n    }\n  ],\n  \"status\": \"open\",\n  \"priority\": -10,\n  \"subject\": \"Ticket subject\",\n  \"teamIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"requester\": {\n    \"email\": \"requester@email.com\",\n    \"name\": \"John Client\"\n  },\n  \"cc\": [\n    {\n      \"email\": \"cc@email.com\",\n      \"name\": \"John Client\"\n    }\n  ],\n  \"tagIDs\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"followers\": [\n    \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n  ],\n  \"assignment\": {\n    \"team\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    },\n    \"agent\": {\n      \"ID\": \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    }\n  },\n  \"integration\": {\n    \"type\": \"livechat\",\n    \"referenceType\": \"\",\n    \"referenceURL\": \"\",\n    \"referenceID\": \"\"\n  },\n  \"customFields\": {\n    \"order-id\": \"1234\"\n  },\n  \"author\": {\n    \"type\": \"client\"\n  },\n  \"message\": {\n    \"text\": \"Hello from a ticket!\",\n    \"cannedResponseIDs\": [\n      \"42e113f9-9353-4e89-9f68-69b92f423b0c\"\n    ]\n  },\n  \"isPrivate\": true,\n  \"transactionID\": \"050340e4-82de-4a2a-a1c4-724dfaf66cec\"\n}"

response = http.request(request)
puts response.read_body

{
  "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
  "licenseID": 13381337,
  "createdAt": "2026-06-30T22:02:08.901Z",
  "createdBy": "f56caf69-3f05-4386-9567-fdc909d7ad77",
  "createdByType": "agent",
  "updatedAt": "2026-06-30T22:02:08.901Z",
  "updatedBy": "f56caf69-3f05-4386-9567-fdc909d7ad77",
  "shortID": "IIPZGJ",
  "lastMessageAt": "2026-06-30T22:02:08.901Z",
  "parentTicket": {
    "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
    "shortID": "IIPZGJ",
    "subject": "Parent ticket subject"
  },
  "childTickets": [
    {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "shortID": "IIPZGJ",
      "subject": "Child ticket subject"
    }
  ],
  "status": "open",
  "priority": -10,
  "subject": "Ticket subject",
  "teamIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "requester": {
    "email": "",
    "name": ""
  },
  "cc": [
    {
      "email": "cc@email.com",
      "name": "John Client"
    }
  ],
  "tagIDs": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "followers": [
    "42e113f9-9353-4e89-9f68-69b92f423b0c"
  ],
  "assignment": {
    "team": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "name": ""
    },
    "agent": {
      "ID": "42e113f9-9353-4e89-9f68-69b92f423b0c",
      "name": ""
    }
  },
  "integration": {
    "type": "livechat",
    "referenceType": "",
    "referenceURL": "",
    "referenceID": ""
  },
  "customFields": {
    "order-id": "1234"
  },
  "ratingRequeestSent": true,
  "rating": {
    "rate": "good",
    "comment": "",
    "requestedAt": "2026-06-30T22:02:08.901Z"
  },
  "silo": "tickets",
  "spam": {
    "status": true,
    "reason": "licenseBlackList"
  },
  "source": {
    "type": "api"
  },
  "events": [
    {
      "type": "message"
    }
  ],
  "integrations": {
    "type": "livechat",
    "externalID": ""
  },
  "detectedLanguage": ""
}

Authorizations

Authorization

string

header

required

Use your account ID as the username and your personal access token (PAT) as the password, or pass a Base64-encoded value directly in the Authorization header. For more information, see the personal access tokens guide.

Body

application/json

requester

object

required

Show child attributes

message

object

required

First message in a ticket

Option 1
Option 2

Show child attributes

lastMessageAt

string<date-time>

The time of last public message.

parentTicket

object | null

The parent ticket reference.

Show child attributes

childTickets

object[]

The merged ticket reference.

Show child attributes

status

enum<string>

default:open

Ticket status

Available options:

open,

pending,

onhold,

solved,

closed

priority

enum<integer>

default:0

Value	Priority
-10	low
0	medium
10	high
20	urgent

Available options:

-10,

0,

10,

20

subject

string

teamIDs

string<uuid>[]

The teams that can access the ticket.

Unique object identifier

object[]

A list of people in the loop.

Show child attributes

tagIDs

string<uuid>[]

A list of ticket tags.

Unique object identifier

followers

string<uuid>[]

A list of ticket followers (agents).

Unique object identifier

assignment

object

The team or agent assignment.

Show child attributes

integration

object

Show child attributes

customFields

object

Object with custom fields values, where key is custom fields apiKey.

Example:

{ "order-id": "1234" }

author

object

Show child attributes

isPrivate

boolean

default:false

Is first message a private message.

transactionID

string<uuid>

References transaction containing uploaded attachments used in ticket's message content.

Response

200 - application/json

Successful response.

string<uuid>

Unique object identifier.

licenseID

integer

Unique account identifier.

createdAt

string<date-time>

The time of creation.

createdBy

string<uuid>

The creator identifier.

createdByType

enum<string>

The creator type.

Available options:

agent,

client,

system

updatedAt

string<date-time>

The time of last modification.

updatedBy

string<uuid>

The modification author identifier.

shortID

string

The short ticket ID.

lastMessageAt

string<date-time>

The time of last public message.

parentTicket

object | null

The parent ticket reference.

Show child attributes

childTickets

object[]

The merged ticket reference.

Show child attributes

status

enum<string>

default:open

Ticket status

Available options:

open,

pending,

onhold,

solved,

closed

priority

enum<integer>

default:0

Value	Priority
-10	low
0	medium
10	high
20	urgent

Available options:

-10,

0,

10,

20

subject

string

teamIDs

string<uuid>[]

The teams that can access the ticket.

Unique object identifier

requester

object

Ticket requester

Show child attributes

object[]

A list of people in the loop.

Show child attributes

tagIDs

string<uuid>[]

A list of ticket tags.

Unique object identifier

followers

string<uuid>[]

A list of ticket followers (agents).

Unique object identifier

assignment

object

Team / agent assignment

Show child attributes

integration

object

Show child attributes

customFields

object

Object with custom fields values, where key is custom fields apiKey.

Example:

{ "order-id": "1234" }

ratingRequeestSent

boolean

default:false

Has rating request been sent.

rating

object | null

Ticket rating

Show child attributes

silo

enum<string>

default:tickets

Ticket silo (folder). Please check ticket silos section for more information

Available options:

tickets,

archive,

trash,

spam

spam

object

Show child attributes

source

object

Option 1
Option 2
Option 3
Option 4

Show child attributes

events

object[]

The ticket events.

Show child attributes

integrations

object

Option 1
Option 2

Show child attributes

detectedLanguage

string

The detected language code.

List tickets

Get ticket

Agents

Canned responses

Custom fields

Email domains

Mailboxes (inboxes)

Licenses

Reply addresses

Reports

Rules

Macros

Spam management

Tags

Teams

Templates

Audit log

Tickets

Transactions

Views

Webhooks

Imported tickets

Authorizations

Body

Response