Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Zendesk connection the step signs in with. |
| Your own id | Only the tickets carrying this external id. |
| Order | "-updated_at" or "updated_at" or "-id" or "id" or "-status" or "status" |
| Changed since | Only 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 fetch | Comma-separated related records Zendesk returns beside the tickets. |
| Tickets per call | 1 to 100. |
| Fetch every page | Follows 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. |
| Cursor | Paste a previous run's Next cursor to read the page after it. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `zendesk`) |
externalId | text |
sort | "-updated_at" or "updated_at" or "-id" or "id" or "-status" or "status", by default "-updated_at" |
startTime | text |
supportTypeScope | "agent" or "all" or "ai_agent", by default "agent" |
sideloads | text |
limit | number, by default 100 |
returnAll | true/false, by default false |
cursor | text |
Output
| Field | Type |
|---|---|
tickets | array |
ticketCountTickets in this answer | number |
hasMoreMore tickets are waiting behind this page | boolean |
nextCursorCursor for the next page | string |
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
| Setting | What it is |
|---|---|
| ConnectionRequired | The Zendesk connection the step signs in with. |
| Your own id | Only the tickets carrying this external id. |
| Order | "-updated_at" or "updated_at" or "-id" or "id" or "-status" or "status" |
| Changed since | Only 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 fetch | Comma-separated related records Zendesk returns beside the tickets. |
| Tickets per call | 1 to 100. |
| Fetch every page | Follows 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
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `zendesk`) |
externalId | text |
sort | "-updated_at" or "updated_at" or "-id" or "id" or "-status" or "status", by default "-updated_at" |
startTime | text |
supportTypeScope | "agent" or "all" or "ai_agent", by default "agent" |
sideloads | text |
limit | number, by default 100 |
returnAll | true/false, by default false |