Tickets

Create a support ticket. A customer record is automatically created or matched by email.

const ticket = await helmdesk.tickets.create({
  subject: 'Cannot login',
  body: 'I keep getting a 403 error when...',
  customerEmail: 'user@example.com',
  customerName: 'Jane Smith',
  priority: 'high',
})

List tickets with pagination. Filter by status, priority, or search by subject/email.

const { tickets, total } = await helmdesk.tickets.list({
  status: 'open',
  priority: 'high',
  page: 1,
  limit: 25,
})

Get full ticket details including messages, tags, and customer info.

const ticket = await helmdesk.tickets.get('ticket-uuid')
// ticket.messages, ticket.tags, ticket.customer

Update ticket status, priority, category, or assignee.

await helmdesk.tickets.update('ticket-uuid', {
  status: 'resolved',
  priority: 'low',
})

Add a message to a ticket thread. Use this to reply to tickets from your own UI.

await helmdesk.tickets.addMessage('ticket-uuid', {
  body: 'Thanks for reaching out! Here\'s how to fix it...',
})