ticket_created

Sent when a new ticket is created in a project. This event belongs to a ticket rather than to a call, so it does not carry call fields such as unique_id or pbx_num; correlate tickets with the ticket_id field.

If the ticket was assigned to an agent while it was being created, a separate ticket_assigned event is sent after this one.

Sample body

scenario: ticket_created

{
  "ticket_id": 1542,
  "project_id": 12,
  "organization_id": 345,
  "data": {
    "status_id": 4,
    "priority": "medium",
    "assigned_to": 27,
    "tags": [
      {
        "id": 3,
        "name": "vip",
        "color": "#ff9f43"
      }
    ]
  },
  "ticket_key": "DESTEK-87",
  "ticket_number": 87,
  "form_id": 31,
  "contact_id": 9001,
  "tags": [
    {
      "id": 3,
      "name": "vip",
      "color": "#ff9f43"
    }
  ],
  "fields": {
    "konu": "Fatura itirazı",
    "aciklama": "Ocak faturasındaki ek ücret hakkında bilgi istiyor.",
    "ek": {
      "file_name": "fatura.pdf",
      "mime_type": "application/pdf",
      "size": 48213
    }
  },
  "created_at": "2026-01-01T07:00:00+00:00",
  "updated_at": "2026-01-01T07:00:00+00:00",
  "channel": "call"
}

Send this body to your own address

The sample body above is sent to the address below as a POST request. The request goes from your browser, so the response cannot be read if the receiving endpoint sends no CORS header; the request itself still arrives. Use the cURL equivalent to try it from the server side.

cURL equivalent:

curl -X POST 'https://your-address.example/webhook' \
  -H 'Content-Type: application/json' \
  -d '{"ticket_id":1542,"project_id":12,"organization_id":345,"data":{"status_id":4,"priority":"medium","assigned_to":27,"tags":[{"id":3,"name":"vip","color":"#ff9f43"}]},"ticket_key":"DESTEK-87","ticket_number":87,"form_id":31,"contact_id":9001,"tags":[{"id":3,"name":"vip","color":"#ff9f43"}],"fields":{"konu":"Fatura itirazı","aciklama":"Ocak faturasındaki ek ücret hakkında bilgi istiyor.","ek":{"file_name":"fatura.pdf","mime_type":"application/pdf","size":48213}},"created_at":"2026-01-01T07:00:00+00:00","updated_at":"2026-01-01T07:00:00+00:00","channel":"call"}'

Fields

Field	Type	Description
ticket_id	number	Unique identifier of the ticket. Correlate events of the same ticket with this field.
project_id	number	Identifier of the project the ticket belongs to.
organization_id	number	Identifier of your organization.
data	object	Ticket details sent when the ticket was created: status_id, priority, assigned_to and tags.
ticket_key	string	Ticket code made of the project key and the sequence number, e.g. DESTEK-87.
ticket_number	number	Sequence number of the ticket within the project.
form_id	number	Identifier of the form the ticket was filled in with.
contact_id	number	Identifier of the contact the ticket is linked to. null when there is no contact.
tags	array	Tags added to the ticket; each carries id, name and color.
fields	object	Form fields filled in, keyed by the form field key. Uploaded files are replaced by a file_name, mime_type and size summary.
created_at	string	Creation time of the ticket, ISO 8601.
updated_at	string	Last update time of the ticket, ISO 8601.
channel	string	Channel the ticket was opened from, e.g. call, whatsapp, livechat, email, sms. null when unknown.

Numeric fields really are numbers

Unlike the call scenarios, identifier fields such as ticket_id and project_id are sent unquoted in ticket events, that is as a number.