# Ticket events

URL: https://developers.cuedesk.com/webhooks/ticket_events

> Webhook payloads for the ticket created, ticket closed and ticket updated events.

Below is an overview of the different webhook payloads that customers can receive for ticket events from the Cue platform. The key ticket events include _ticket_created_, _ticket_closed_, and _ticket_updated_. Each event provides a specific payload that contains relevant information about the ticket's status and associated data.

<Callout type="info">
`contact.phoneNumber` is omitted for a WhatsApp customer who has hidden their phone number. See [WhatsApp usernames and BSUIDs](/webhooks/whatsapp_usernames_and_bsuids).
</Callout>

## Ticket created [#ticket-created]

When a ticket is created, a webhook is triggered with the following payload:

```json
{
  "createdAt": "2024-06-25T21:21:40.575968742Z",
  "trigger": "ticket_created",
  "webhookVersion": "1.0.0",
  "event": {
    "eventType": "ticket_created",
    "channelUuid": "ff03aa48-c01c-4304-b53a-fe90f4b5615a",
    "sessionUuid": "ff14a27b-551c-48f7-ab0a-38fc71ce2fee",
    "ticket": {
      "uuid": "ff11e1a7-9605-49c9-b84f-9b5a61d21af9",
      "shortId": "CUE-123",
      "assignee": {
        "name": "Alex Morgan",
        "email": "alex@company.com"
      },
      "team": {
        "name": "Support",
        "uuid": "ff10ad69-1311-42ea-b482-3e0040155a10",
        "externalUniqueIdentifier": "SUPPORT-01"
      },
      "contact": {
        "firstname": "Evans",
        "lastname": "Shaw",
        "email": "test@cue.com",
        "phoneNumber": "27734378471",
        "clientReference": "cue1@test.com",
        "externalContactId": "cue1@test.com"
      }
    }
  }
}
```

## Ticket closed [#ticket-closed]

When a ticket is closed, a webhook is triggered with the following payload:

```json
{
  "createdAt": "2024-06-25T21:21:40.575968742Z",
  "trigger": "ticket_closed",
  "webhookVersion": "1.0.0",
  "event": {
    "eventType": "ticket_closed",
    "channelUuid": "ff033ebd-ac63-4fd4-bea1-d63b363478f2",
    "sessionUuid": "ff14a27b-551c-48f7-ab0a-38fc71ce2fee",
    "ticket": {
      "uuid": "ff11e1a7-9605-49c9-b84f-9b5a61d21af9",
      "shortId": "CUE-123",
      "assignee": {
        "name": "Alex Morgan",
        "email": "alex@company.com"
      },
      "closedBy": {
        "name": "Alex Morgan",
        "email": "alex@company.com"
      },
      "team": {
        "name": "Support",
        "uuid": "ff10ad69-1311-42ea-b482-3e0040155a10"
      },
      "tags": [
        {
          "name": "General enquiry",
          "uuid": "ff17b4eb-9901-42ea-ad32-3e00649bda10"
        }
      ],
      "contact": {
        "firstname": "Evans",
        "lastname": "Shaw",
        "email": "test@cue.com",
        "phoneNumber": "27734378471",
        "clientReference": "cue1@test.com",
        "externalContactId": "cue1@test.com"
      }
    }
  }
}
```

## Ticket updated [#ticket-updated]

The _ticket_updated_ event can trigger several different payloads based on the type of update.

<Tabs items={["First response","Team change","Tag change","User change"]}>
<Tab value="First response">

```json
{
  "createdAt": "2024-10-21T13:52:27.966704382Z",
  "trigger": "ticket_updated",
  "webhookVersion": "1.0.0",
  "event": {
    "eventType": "first_response",
    "channelUuid": "ff03aa48-c01c-4304-b53a-fe90f4b5615a",
    "sessionUuid": "ff143f26-f678-4b02-929e-16d24cbb8295",
    "ticket": {
      "uuid": "ff114d61-8d35-415e-ad69-72bec566d265",
      "shortId": "CUE-123",
      "assignee": {
        "name": "Alex Morgan",
        "email": "alex@company.com"
      },
      "team": {
        "name": "Support",
        "uuid": "ff10b901-5ff2-4ec5-86ce-84decc456a5d",
        "externalUniqueIdentifier": "SUPPORT-01"
      },
      "tags": [],
      "firstResponseTime": "2024-10-21T13:52:27",
      "contact": {
        "firstname": "Evans",
        "lastname": "Shaw",
        "email": "test@cue.com",
        "phoneNumber": "27734378471",
        "clientReference": "cue1@test.com",
        "externalContactId": "cue1@test.com"
      }
    }
  }
}
```

</Tab>
<Tab value="Team change">

```json
{
  "createdAt": "2024-10-21T13:53:03.408915747Z",
  "trigger": "ticket_updated",
  "webhookVersion": "1.0.0",
  "event": {
    "eventType": "team_change",
    "channelUuid": "ff03aa48-c01c-4304-b53a-fe90f4b5615a",
    "sessionUuid": "ff143f26-f678-4b02-929e-16d24cbb8295",
    "ticket": {
      "uuid": "ff114d61-8d35-415e-ad69-72bec566d265",
      "shortId": "CUE-123",
      "assignee": {
        "name": "Alex Morgan",
        "email": "alex@company.com"
      },
      "team": {
        "name": "Complaints",
        "uuid": "ff10a994-d08d-440b-8ad1-ce17248adfb6",
        "externalUniqueIdentifier": "COMPLAINTS-01"
      },
      "tags": [],
      "firstResponseTime": "2024-10-21T13:52:27",
      "contact": {
        "firstname": "Evans",
        "lastname": "Shaw",
        "email": "test@cue.com",
        "phoneNumber": "27734378471",
        "clientReference": "cue1@test.com",
        "externalContactId": "cue1@test.com"
      }
    }
  }
}
```

</Tab>
<Tab value="Tag change">

```json
{
  "createdAt": "2024-10-21T13:53:06.221368188Z",
  "trigger": "ticket_updated",
  "webhookVersion": "1.0.0",
  "event": {
    "eventType": "tag_change",
    "channelUuid": "ff03aa48-c01c-4304-b53a-fe90f4b5615a",
    "sessionUuid": "ff143f26-f678-4b02-929e-16d24cbb8295",
    "ticket": {
      "uuid": "ff114d61-8d35-415e-ad69-72bec566d265",
      "shortId": "CUE-123",
      "assignee": {
        "name": "Alex Morgan",
        "email": "alex@company.com"
      },
      "team": {
        "name": "Complaints",
        "uuid": "ff10a994-d08d-440b-8ad1-ce17248adfb6",
        "externalUniqueIdentifier": "COMPLAINTS-01"
      },
      "tags": [
        {
          "name": "Follow Up",
          "uuid": "ff173d8b-132c-4462-bd15-46e88d25a6a8"
        }
      ],
      "firstResponseTime": "2024-10-21T13:52:27",
      "contact": {
        "firstname": "Evans",
        "lastname": "Shaw",
        "email": "test@cue.com",
        "phoneNumber": "27734378471",
        "clientReference": "cue1@test.com",
        "externalContactId": "cue1@test.com"
      }
    }
  }
}
```

</Tab>
<Tab value="User change">

```json
{
  "createdAt": "2024-10-21T13:57:06.221451136Z",
  "trigger": "ticket_updated",
  "webhookVersion": "1.0.0",
  "event": {
    "eventType": "user_change",
    "channelUuid": "ff03aa48-c01c-4304-b53a-fe90f4b5615a",
    "sessionUuid": "ff143f26-f678-4b02-929e-16d24cbb8295",
    "ticket": {
      "uuid": "ff114d61-8d35-415e-ad69-72bec566d265",
      "shortId": "CUE-123",
      "assignee": {
        "name": "Jennifer Wehr",
        "email": "jennifer@company.com"
      },
      "team": {
        "name": "Complaints",
        "uuid": "ff10a994-d08d-440b-8ad1-ce17248adfb6",
        "externalUniqueIdentifier": "COMPLAINTS-01"
      },
      "tags": [
        {
          "name": "Follow Up",
          "uuid": "ff173d8b-132c-4462-bd15-46e88d25a6a8"
        }
      ],
      "firstResponseTime": "2024-10-21T13:52:27",
      "contact": {
        "firstname": "Evans",
        "lastname": "Shaw",
        "email": "test@cue.com",
        "phoneNumber": "27734378471",
        "clientReference": "cue1@test.com",
        "externalContactId": "cue1@test.com"
      }
    }
  }
}
```

</Tab>
</Tabs>
