FreshdeskList tickets
BetaReads data
Lists Freshdesk tickets, newest first, with the filters Freshdesk offers.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Freshdesk connection the step signs in with. |
| Predefined filter | "" or "new_and_my_open" or "watching" or "spam" or "deleted" |
| Requester id | text |
| Requester e-mail | text |
| Requester external id | text |
| Company id | text |
| Updated since | Without this, Freshdesk only returns tickets created in the last 30 days. That is its single most surprising rule. |
| Order by | "created_at" or "due_by" or "updated_at" or "status" |
| Direction | "desc" or "asc" |
| Extras | Comma-separated. Each extra costs an extra API call credit per ticket. |
| Tickets per call | 1 to 100. |
| Fetch every page | Follows Freshdesk's own next-page link, and refuses past 5,000 tickets or 300 pages rather than answering a short list. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `freshdesk`) |
filter | "" or "new_and_my_open" or "watching" or "spam" or "deleted" |
requesterId | text |
email | text |
uniqueExternalId | text |
companyId | text |
updatedSince | text |
orderBy | "created_at" or "due_by" or "updated_at" or "status", by default "created_at" |
orderType | "desc" or "asc", by default "desc" |
include | text |
limit | number, by default 100 |
returnAll | true/false, by default false |
Output
| Field | Type |
|---|---|
tickets | array |
ticketCountTickets in this answer | number |
hasMoreMore tickets are waiting behind this page | boolean |
nextUrlFreshdesk's link to the next page | string |
Sample output, and the expression for each field
- hasMorefalse
- nextUrl""
- 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": {
"companyId": "",
"connection": "<connection id>",
"email": "",
"filter": "",
"include": "",
"limit": 100,
"orderBy": "created_at",
"orderType": "desc",
"requesterId": "",
"returnAll": false,
"uniqueExternalId": "",
"updatedSince": ""
},
"label": "List tickets",
"type": "freshdesk.listTickets",
"version": 1
}