FreshdeskSettings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Freshdesk connection the step signs in with. |
| Identify the requester by | Freshdesk needs exactly one of these. A new e-mail address creates the contact; a phone number needs a name beside it. |
| RequesterRequired | text |
| Requester name | Freshdesk refuses a ticket identified by phone number without a name. |
| Subject | text |
| Description format | Freshdesk renders a description as HTML. Plain text escapes what you write and turns your line breaks into HTML ones; HTML sends it exactly as typed. |
| DescriptionRequired | The first message of the ticket, as the requester will see it. |
| Status | Freshdesk stores a status as a number; the number is in brackets so an export reads the same as this list. |
| Priority | "low" or "medium" or "high" or "urgent" |
| Source | "email" or "portal" or "phone" or "chat" or "feedback_widget" or "outbound_email" |
| Type | The ticket type as your Freshdesk admin named it, for example Incident. |
| Assign to agent id | The List agents node gives you the ids. |
| Group id | The List groups node gives you the ids. |
| Company id | text |
| Product id | text |
| E-mail config id | Which of your support addresses the ticket belongs to. |
| Parent ticket id | text |
| Cc | text |
| Tags | Comma-separated. |
| Custom fields | Freshdesk keys a custom field by its name, usually prefixed cf_ — the List ticket fields node gives you the names and the allowed choices. |
| Due by | Freshdesk refuses one of the two due dates without the other. |
| First response due by | text |
| Attachments | File name → its base64, for example {{ file("report.pdf").base64 }}. All attachments together may not exceed 20 MB. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `freshdesk`) |
requesterMode | "email" or "requesterId" or "phone" or "uniqueExternalId", by default "email" |
requester | text |
name | textused when `requesterMode` is "phone" |
subject | text |
descriptionFormat | "text" or "html", by default "text" |
description | text |
status | "open" or "pending" or "resolved" or "closed", by default "open" |
priority | "low" or "medium" or "high" or "urgent", by default "low" |
source | "email" or "portal" or "phone" or "chat" or "feedback_widget" or "outbound_email", by default "portal" |
type | text |
responderId | texta value from the vendor's own list |
groupId | texta value from the vendor's own list |
companyId | text |
productId | text |
emailConfigId | text |
parentId | text |
ccEmails | text |
tags | text |
customFields | object of text, by default {} |
dueBy | text |
frDueBy | text |
attachments | object of text, by default {} |
Output
| Field | Type |
|---|---|
ticketId | number |
ticket | object |
ticketUrlLink to the ticket | string |
Sample output, and the expression for each field
- ticket{}
- ticketId42
- ticketUrl"https://acme.freshdesk.com/a/tickets/42"
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": {
"attachments": {},
"ccEmails": "",
"companyId": "",
"connection": "<connection id>",
"customFields": {},
"description": "<description>",
"descriptionFormat": "text",
"dueBy": "",
"emailConfigId": "",
"frDueBy": "",
"groupId": "",
"name": "",
"parentId": "",
"priority": "low",
"productId": "",
"requester": "<requester>",
"requesterMode": "email",
"responderId": "",
"source": "portal",
"status": "open",
"subject": "",
"tags": "",
"type": ""
},
"label": "Create ticket",
"type": "freshdesk.createTicket",
"version": 1
}