FlowmageDocs

List tickets

BetaReads dataVersion 2

Lists Zendesk tickets, newest first, page by page.

Settings

SettingWhat it is
ConnectionRequiredThe Zendesk connection the step signs in with.
Your own idOnly the tickets carrying this external id.
Order"-updated_at" or "updated_at" or "-id" or "id" or "-status" or "status"
Changed sinceOnly tickets changed since this moment. For a real sync use the Tickets changed since node — it never misses one.
Whose tickets"agent" or "all" or "ai_agent"
Also fetchComma-separated related records Zendesk returns beside the tickets.
Tickets per call1 to 100.
Fetch every pageFollows Zendesk's cursor, and refuses past 5,000 tickets rather than answering a short list. Listing tickets is capped at 100 calls a minute, and a separate counter of 50 a minute applies past page 500.
CursorPaste a previous run's Next cursor to read the page after it.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `zendesk`)
externalIdtext
sort"-updated_at" or "updated_at" or "-id" or "id" or "-status" or "status", by default "-updated_at"
startTimetext
supportTypeScope"agent" or "all" or "ai_agent", by default "agent"
sideloadstext
limitnumber, by default 100
returnAlltrue/false, by default false
cursortext

Output

FieldType
ticketsarray
ticketCountTickets in this answernumber
hasMoreMore tickets are waiting behind this pageboolean
nextCursorCursor for the next pagestring
Sample output, and the expression for each field
  • hasMorefalse
  • nextCursor""
  • ticketCount0
  • tickets[]

Errors

When a step of this node stops a run, the run page shows a code. Look it up:

Example step

The step as a flow file holds it. Replace each value in <…>.

{
  "config": {
    "connection": "<connection id>",
    "cursor": "",
    "externalId": "",
    "limit": 100,
    "returnAll": false,
    "sideloads": "",
    "sort": "-updated_at",
    "startTime": "",
    "supportTypeScope": "agent"
  },
  "label": "List tickets",
  "type": "zendesk.listTickets",
  "version": 2
}

Older versions

A flow that already has this version keeps running it. A new step always gets the newest.

Version 1
SettingWhat it is
ConnectionRequiredThe Zendesk connection the step signs in with.
Your own idOnly the tickets carrying this external id.
Order"-updated_at" or "updated_at" or "-id" or "id" or "-status" or "status"
Changed sinceOnly tickets changed since this moment. For a real sync use the Tickets changed since node — it never misses one.
Whose tickets"agent" or "all" or "ai_agent"
Also fetchComma-separated related records Zendesk returns beside the tickets.
Tickets per call1 to 100.
Fetch every pageFollows Zendesk's cursor, and refuses past 5,000 tickets rather than answering a short list. Listing tickets is capped at 100 calls a minute, and a separate counter of 50 a minute applies past page 500.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `zendesk`)
externalIdtext
sort"-updated_at" or "updated_at" or "-id" or "id" or "-status" or "status", by default "-updated_at"
startTimetext
supportTypeScope"agent" or "all" or "ai_agent", by default "agent"
sideloadstext
limitnumber, by default 100
returnAlltrue/false, by default false