Create

POST

/api/v1/tickets

This endpoint allows you to create a new ticket in the system.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢201

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://apigw.klinkcx.com/api/v1/tickets' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "Customer cannot access account",
    "description": "Customer reports being unable to log in after password reset",
    "status": "open",
    "priority": "high",
    "contact_id": "51f5f68f-6a63-4c2e-8a68-53d268d93ae1",
    "channel": "email",
    "tags": [
        "f8d7a5b2-9c63-4e2f-8d1a-5b2c9e6d3f8a"
    ],
    "customFields": {
        "cf_trackingid": "Id-1001",
        // Date custom field must be in ISO-8601 format (YYYY-MM-DD)
        "cf_date": "2025-10-23"
    }
}'

Response Example

{
  "success": true,
  "data": {
    "id": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "deletedAt": null,
    "title": "string",
    "description": "string",
    "type": "string",
    "channel": "string",
    "priority": "string",
    "status": "string",
    "contactId": "string",
    "creatorId": "string",
    "assigneeId": "string",
    "reasonToAssign": "string",
    "ticketNumber": 2323,
    "assignee": {
      "id": "string",
      "name": "string",
      "email": "string"
    },
    "contact": {
      "id": "string",
      "name": "string"
    },
    "tags": [
      {
        "id": "string",
        "name": "string"
      }
    ],
    "customFields": [
      {
        "id": "string",
        "textValue": "string",
        "attribute": {
          "id": "string",
          "systemName": "string",
          "displayName": "string",
          "type": "string"
        }
      }
    ]
  }
}

Modified at 2026-01-09 04:29:50

Listing

Filter by Contact ID