Skip to main content
This is a public endpoint. No authentication token is required. The client IP address is captured automatically from the request.

​
Request

POST /api/tickets/crear

​
Body parameters

​
nombre
string
required
Full name of the requester. Between 3 and 150 characters.
​
email
string
required
Email address of the requester. Must be a valid email format.
​
tipo
string
required
Request type. One of: PETICION, QUEJA, RECLAMO, SUGERENCIA, INCIDENTE, SOLICITUD, CONSULTA.
​
categoria
string
required
Category of the ticket. Between 2 and 100 characters.
​
descripcion
string
required
Detailed description of the request or issue. Minimum 10 characters.
​
prioridad
string
required
Priority level name. Maximum 20 characters (e.g. ALTA, MEDIA, BAJA).
​
documento
string
Identity document number of the requester. Maximum 50 characters.
​
telefono
string
Phone number of the requester. Maximum 30 characters.
​
tieneWhatsapp
boolean
default:"false"
Whether the phone number has WhatsApp enabled.
​
empresaDepartamento
string
Company or department the requester belongs to. Maximum 150 characters.
​
subcategoria
string
Subcategory for finer-grained classification. Maximum 100 characters.
​
asunto
string
Short subject line for the ticket. Maximum 200 characters.
​
areaAsignada
string
default:"MESA"
Area to assign the ticket to on creation. Defaults to MESA. Maximum 100 characters.

​
Response

Returns a 200 OK with the created ticket summary.
​
ticketUuid
string
required
Internal UUID of the newly created ticket.
​
ticketLabel
string
required
Human-readable ticket reference (e.g. TKT-2026-00042). Share this with the requester.
​
estado
string
required
Initial status of the ticket after creation.
​
tipo
string
required
Request type as provided in the request body.
​
prioridad
string
required
Priority level name as provided in the request body.
​
slaHoras
number
required
Number of SLA hours assigned to this ticket based on its priority.
​
fechaCreacion
string
required
ISO 8601 timestamp of when the ticket was created.
​
fechaLimiteSla
string
required
ISO 8601 timestamp of the SLA deadline.
​
mensaje
string
required
Confirmation message returned by the server.

​
Error codes

StatusDescription
400Invalid request body — validation failed (e.g. descripcion too short, invalid email, unrecognized tipo).
422Unprocessable entity — missing required fields.
curl --request POST \
  --url https://api.example.com/api/tickets/crear \
  --header 'Content-Type: application/json' \
  --data '{
    "nombre": "Ana García",
    "email": "[email protected]",
    "telefono": "3001234567",
    "tieneWhatsapp": true,
    "empresaDepartamento": "Recursos Humanos",
    "tipo": "INCIDENTE",
    "categoria": "Sistemas",
    "subcategoria": "Correo electrónico",
    "asunto": "No puedo acceder al correo corporativo",
    "descripcion": "Desde esta mañana no puedo iniciar sesión en el correo corporativo. El sistema muestra error 403.",
    "prioridad": "ALTA"
  }'

{
  "ticketUuid": "e3b2c1d4-5a6f-7890-abcd-ef1234567890",
  "ticketLabel": "TKT-2026-00042",
  "estado": "ABIERTO",
  "tipo": "INCIDENTE",
  "prioridad": "ALTA",
  "slaHoras": 4,
  "fechaCreacion": "2026-03-24T09:15:00Z",
  "fechaLimiteSla": "2026-03-24T13:15:00Z",
  "mensaje": "Ticket creado exitosamente"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us