Enigma Developers
API ReferenceTickets

Create a ticket

POST
/v1/tickets

Creates a ticket, optionally linked to a contact. status defaults to open and priority to medium. Requires scope tickets:create.

Authorization

headerAuthorizationBearer <token>

Your organization API key: Authorization: Bearer org_…

Request Body

application/json
  1. body
subject*string
title?stringDeprecated

Old name for subject. Used only when subject is missing.

description*string
status?TicketStatus
Value in"open""in_progress""resolved""closed"
priority?TicketPriority
Value in"low""medium""high""urgent"
assigneeId?string

Dashboard user ID to assign.

audienceExternalId?AudienceExternalId

The contact's ID on its channel. For WhatsApp it is <phone number>:<your WhatsApp phone number ID>.

audienceId?string

Internal contact ID. Prefer audienceExternalId.

Response Body

Created.

application/json
  1. response
_id?string
ticketId?string

Human-readable ticket ID; use it in the ticket URLs.

title?string

The ticket subject.

description?string
status?TicketStatus
Value in"open""in_progress""resolved""closed"
priority?TicketPriority
Value in"low""medium""high""urgent"
assigneeId?string|null
audienceId?string|null
organizationId?string
resolutionDate?|
Formatdate-time
createdAt?string
Formatdate-time
updatedAt?string
Formatdate-time
curl -X POST 'https://api.enigma-ai.com/v1/tickets' \  -H 'Content-Type: application/json' \  -d '{  "subject": "string",  "description": "string"}'
{  "_id": "string",  "ticketId": "string",  "title": "string",  "description": "string",  "status": "open",  "priority": "low",  "assigneeId": "string",  "audienceId": "string",  "organizationId": "string",  "resolutionDate": "2019-08-24T14:15:22Z",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}