Skip to main content
GET
/
v1
/
contacts
/
{id}
/
helpdesk-tickets
List helpdesk tickets for a contact
curl --request GET \
  --url https://api.conduit.ai/v1/contacts/{id}/helpdesk-tickets \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "hd77c0dy0mgdpzmqz6tesry8w184002s",
      "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
      "contact_id": "ph77c0dy0mgdpzmqz6tesry8w184002s",
      "ticket_id": "tk77c0dy0mgdpzmqz6tesry8w184002s",
      "connection_id": "cn77c0dy0mgdpzmqz6tesry8w184002s",
      "external_ticket_id": "zd_12345",
      "external_group_id": "grp_42",
      "external_assignee_id": "usr_987",
      "subject": "Unable to access door code",
      "description": "Guest reports the keypad is not accepting the code.",
      "status": "open",
      "priority": "high",
      "type": "incident",
      "channel": "email",
      "tags": [
        "urgent",
        "access"
      ],
      "requester": {
        "external_id": "zd_user_abc",
        "name": "Taylor Reid",
        "email": "taylor.reid@example.com"
      },
      "last_external_update_at": "2026-04-19T14:05:00.000Z",
      "created_at": "2026-04-19T13:48:00.000Z"
    }
  ],
  "next_cursor": "page-token",
  "has_more": true
}

Authorizations

Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Path Parameters

id
string
required

Contact id.

Example:

"ph77c0dy0mgdpzmqz6tesry8w184002s"

Query Parameters

workspace_id
string

Optional workspace override. If omitted, Conduit resolves the contact's workspace automatically.

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

limit
integer

Page size. Defaults to 20. Max 100.

Required range: 1 <= x <= 100
cursor
string
order
enum<string>

Sort direction. Defaults to desc.

Available options:
asc,
desc
status
string

Filter by helpdesk status. Values depend on the upstream helpdesk system.

channel
string

Filter by the channel the ticket arrived on.

connection_id
string

Filter to tickets from a single helpdesk connection (Zendesk/Pylon/Plain instance).

Response

Contact helpdesk tickets

Cursor-paginated helpdesk tickets response.

data
object[]
required
next_cursor
string | null
required
has_more
boolean
required