Skip to main content
POST

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

Create Ticket with Customer ID

Create Ticket with Messages

Response

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