Skip to main content
POST
/
api
/
ext-v1
/
ticket
/
createTicket
curl -X POST https://admin.telemetron.ai/api/ext-v1/ticket/createTicket \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Device not connecting to WiFi",
    "description": "Customer reports their device fails to connect after firmware update v2.3.1",
    "priority": "high",
    "customerEmail": "john.doe@example.com",
    "category": "Connectivity"
  }'

{
  "success": true,
  "ticketId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Ticket created successfully"
}

​
Overview

Creates a new support ticket in Telemetron. Behavior:
  • Requires either customerEmail or customerId to associate the ticket with a customer
  • If customerEmail is provided and no matching customer exists, a new customer is created automatically
  • Tickets are automatically categorized and routed based on your organization’s rules

​
Authentication

​
x-api-key
string
required
Your organization’s API key

​
Request Body

​
title
string
required
Ticket title (max 255 characters)
​
description
string
Detailed description of the issue or request
​
priority
string
default:"medium"
Ticket priority. One of: low, medium, high, urgent
​
customerEmail
string
Customer’s email address. If the customer doesn’t exist, one will be created automatically. Either customerEmail or customerId is required.
​
customerId
string
Existing Telemetron customer ID. Use this if you already have the customer’s ID from a previous API call. Either customerEmail or customerId is required.
​
category
string
Category name for ticket routing. Must match an existing category in your organization. If not provided or not matched, the ticket will be categorized automatically by AI.
​
messages
array
Conversation history to include with the ticket. Each message has a role (customer, agent, or bot) and content string. If no description is provided, messages are used to generate the ticket description automatically. The first customer message is also included in Slack notifications.

​
Response

​
success
boolean
Indicates if the operation was successful
​
ticketId
string
The unique identifier for the created ticket
​
message
string
Description of the operation result

​
Examples

​
Create Ticket with Customer Email

curl -X POST https://admin.telemetron.ai/api/ext-v1/ticket/createTicket \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Device not connecting to WiFi",
    "description": "Customer reports their device fails to connect after firmware update v2.3.1",
    "priority": "high",
    "customerEmail": "john.doe@example.com",
    "category": "Connectivity"
  }'

​
Create Ticket with Customer ID

curl -X POST https://admin.telemetron.ai/api/ext-v1/ticket/createTicket \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Battery draining too fast",
    "customerId": "cust_a1b2c3d4e5f6",
    "priority": "medium"
  }'

​
Create Ticket with Messages

curl -X POST https://admin.telemetron.ai/api/ext-v1/ticket/createTicket \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Device overheating during charging",
    "customerEmail": "john.doe@example.com",
    "priority": "high",
    "messages": [
      { "role": "customer", "content": "My device gets very hot when I plug it in to charge." },
      { "role": "bot", "content": "I'\''m sorry to hear that. How long has this been happening?" },
      { "role": "customer", "content": "Started about a week ago after the latest update." }
    ]
  }'

​
Response

{
  "success": true,
  "ticketId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Ticket created successfully"
}

curl -X POST https://admin.telemetron.ai/api/ext-v1/ticket/createTicket \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Device not connecting to WiFi",
    "description": "Customer reports their device fails to connect after firmware update v2.3.1",
    "priority": "high",
    "customerEmail": "john.doe@example.com",
    "category": "Connectivity"
  }'

{
  "success": true,
  "ticketId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Ticket created successfully"
}

​
Status Codes

CodeDescription
200Ticket created successfully
400Invalid request (missing required fields, invalid JSON payload, or invalid priority)
401Invalid or missing API key
404Customer not found (when using customerId)
500Internal server error