Connectors
Customer Support & Success
Freshdesk
Customer support: tickets, contacts, companies, and agent assignments
Freshdesk API referenceAPI checked August 15, 2026
- Signs in with
- Username and password
- Runs on
- Cloud or On-Prem Worker
- Operations
- 263
- Ready-made triggers
- 0
Connect Freshdesk
- In Neblex open Connect › Connections and click New Connection.
- Search for Freshdesk and give the connection a clear name.
- Fill in the fields. Secret values are encrypted and never shown again.
- Click Test, then Create Connection.
| Field | What to enter |
|---|---|
| Helpdesk domainRequired | The subdomain of your helpdesk: {domain}.freshdesk.com. |
| API keyRequiredSecret | Your Freshdesk API key, sent as the basic-auth username. |
Use it in a flow
- Open a flow, open the node library and search for Freshdesk.
- Drag it onto the canvas and choose an Operation and your connection.
- Map the operation's fields from earlier steps, or click Map with Matt.
- Use Test this step to see what it returns, then save.
To start a flow from Freshdesk without a ready-made trigger: a Poll for changes trigger can check one of its list operations on a schedule and pass on only what is new; if Freshdesk can send webhooks, a Webhook trigger receives them at its own URL.
Operations
263 operations in 25 groups. Each one is a step you can add to a flow.
Account4
Export accountexportAccount | POST | Start a full account export. |
View a jobgetJob | GET | Status of a background job. |
View accountgetAccount | GET | The current helpdesk account. |
View helpdesk settingsgetHelpdeskSettings | GET | Helpdesk-wide settings. |
Agent11
Agent availabilitygetAgentAvailability | GET | One agent's channel availability. |
Autocomplete agentssearchAgents | GET | Search agents by a term. |
Create an agentcreateAgent | POST | Add an agent with scope and roles. |
Create multiple agentsbulkCreateAgents | POST | Create agents in bulk. |
Current agentgetCurrentAgent | GET | The authenticated agent. |
Delete an agentdeleteAgent | DELETE | Downgrade an agent to a contact. |
Get an agentgetAgent | GET | One agent. |
List agentslistAgents | GET | Agents with email/phone/state filters. |
List All Agents AvailabilitylistAgentAvailability | GET | List All Agents Availability |
Update agent loadupdateAgentAvailability | PUT | Update an agent's load settings. |
Update an agentupdateAgent | PUT | Change an agent's scope, groups or signature. |
Automation6
Create automation rulecreateAutomationRule | POST | Add an automation rule with conditions and actions. |
Delete automation ruledeleteAutomationRule | DELETE | Remove an automation rule. |
Get automation rulegetAutomationRule | GET | One automation rule. |
List automation ruleslistAutomationRules | GET | Rules of an automation type (1 ticket-creation/3 time-trigger/4 ticket-update). |
List scenario automationslistScenarioAutomations | GET | All scenario automations (legacy route). |
Update automation ruleupdateAutomationRule | PUT | Change an automation rule. |
Business Hours2
Get business hoursgetBusinessHour | GET | One business-hours configuration. |
List business hourslistBusinessHours | GET | All business-hours configurations. |
Canned Response9
Bulk create responsesbulkCreateCannedResponses | POST | Create several canned responses. |
Create canned responsecreateCannedResponse | POST | Add a canned response to a folder. |
Create foldercreateCannedResponseFolder | POST | Add a canned response folder. |
Folder response detailsgetFolderResponsesDetails | GET | Full details of a folder's canned responses. |
Get canned responsegetCannedResponse | GET | One canned response. |
List folder responsesgetCannedResponseFolder | GET | Canned responses in a folder. |
List folderslistCannedResponseFolders | GET | All canned response folders. |
Update canned responseupdateCannedResponse | PUT | Change a canned response. |
Update folderupdateCannedResponseFolder | PUT | Rename a canned response folder. |
Collaboration9
Create a messagecreateThreadMessage | POST | Post a message into a thread. |
Create a threadcreateThread | POST | Start a collaboration thread on a ticket. |
Delete a messagedeleteThreadMessage | DELETE | Remove a thread message. |
Delete a threaddeleteThread | DELETE | Remove a collaboration thread. |
Get a messagegetThreadMessage | GET | One thread message. |
Get a threadgetThread | GET | One collaboration thread. |
Get quoted textgetQuotedText | GET | Quoted text for a message. |
Update a messageupdateThreadMessage | PUT | Edit a thread message. |
Update a threadupdateThread | PUT | Change a collaboration thread. |
Company13
Autocomplete companiessearchCompanies | GET | Search companies by name. |
Cancel company importcancelCompanyImport | PUT | Cancel a running company import. |
Company ImportimportCompanies | POST | Company Import |
Create a companycreateCompany | POST | Add a company. |
Delete a companydeleteCompany | DELETE | Remove a company (contacts are not deleted). |
Export companiesexportCompanies | POST | Start a company export with chosen fields. |
Filter companiesfilterCompanies | GET | Query companies with the filter query language. |
Get a companygetCompany | GET | One company. |
Get company exportgetCompanyExport | GET | Status/result of a company export. |
Get company importgetCompanyImport | GET | One company import job. |
List companieslistCompanies | GET | All companies. |
List company importslistCompanyImports | GET | Company import jobs. |
Update a companyupdateCompany | PUT | Change a company. |
Company Field5
Create a company fieldcreateCompanyField | POST | Add a custom company field. |
Delete a company fielddeleteCompanyField | DELETE | Remove a custom company field. |
Get a company fieldgetCompanyField | GET | One company field. |
List company fieldslistCompanyFields | GET | All company fields. |
Update a company fieldupdateCompanyField | PUT | Change a company field. |
Contact21
Autocomplete contactssearchContacts | GET | Search contacts by a term. |
Cancel contact importcancelContactImport | PUT | Cancel a running contact import. |
Contact ImportimportContacts | POST | Contact Import |
Create a contactcreateContact | POST | Add a contact (one identifier among email/phone/mobile/twitter/external is required). |
Create a contact with an avatarcreateContactWithAvatar | POST | Add a contact (one identifier among email/phone/mobile/twitter/external is required). |
Export contactsexportContacts | POST | Start a contact export with chosen fields. |
Filter contactsfilterContacts | GET | Query contacts with the filter query language. |
Get a contactgetContact | GET | One contact. |
Get contact exportgetContactExport | GET | Status/result of a contact export. |
Get contact importgetContactImport | GET | One contact import job. |
List contact importslistContactImports | GET | Contact import jobs. |
List contactslistContacts | GET | Contacts with identifier and state filters. |
Make agentmakeContactAgent | PUT | Convert a contact into an agent. |
Merge contactsmergeContacts | POST | Merge secondary contacts into a primary contact. |
Permanently delete contacthardDeleteContact | DELETE | Hard-delete a contact (irreversible). |
Publish activitiespublishContactActivity | POST | Publish omnichannel contact activities. |
Restore a contactrestoreContact | PUT | Restore a soft-deleted contact. |
Send invitesendContactInvite | PUT | Send an activation email to a contact. |
Soft delete a contactdeleteContact | DELETE | Soft-delete a contact. |
Update a contactupdateContact | PUT | Change a contact's details. |
Update a contact with an avatarupdateContactWithAvatar | PUT | Change a contact's details. |
Contact Field5
Create a contact fieldcreateContactField | POST | Add a custom contact field. |
Delete a contact fielddeleteContactField | DELETE | Remove a custom contact field. |
Get a contact fieldgetContactField | GET | One contact field. |
List contact fieldslistContactFields | GET | All contact fields. |
Update a contact fieldupdateContactField | PUT | Change a contact field. |
Conversation11
Add a noteaddNote | POST | Add a private or public note (body or structured body mandatory). |
Create a note with attachmentsaddNoteWithAttachments | POST | Add a private or public note (body or structured body mandatory). |
Delete a conversationdeleteConversation | DELETE | Delete a note or reply. |
Get outbound messagegetOutboundMessage | GET | Status of a proactive message. |
List ticket conversationslistTicketConversations | GET | All conversations of a ticket. |
Reply to a ticketreplyToTicket | POST | Add a public reply (body or structured body mandatory). |
Reply to a ticket with attachmentsreplyToTicketWithAttachments | POST | Add a public reply (body or structured body mandatory). |
Reply to forwardreplyToForward | POST | Reply on a forwarded conversation. |
Send proactive messagesendOutboundMessage | POST | Send a proactive outbound channel message. |
Update a conversationupdateConversation | PUT | Edit a note or reply's body. |
Update a conversation with attachmentsupdateConversationWithAttachments | PUT | Edit a note or reply's body. |
Custom Object9
Count recordscountCustomObjectRecords | GET | Record count for a custom object. |
Create a recordcreateCustomObjectRecord | POST | Add a record to a custom object (fields per schema). |
Delete a recorddeleteCustomObjectRecord | DELETE | Remove a custom object record. |
Filter Records Of A Custom ObjectfilterCustomObjectRecords | GET | Filter Records Of A Custom Object |
Get a custom objectgetCustomObject | GET | One custom object schema. |
Get a recordgetCustomObjectRecord | GET | One custom object record. |
List custom objectslistCustomObjects | GET | Custom object schemas. |
List recordslistCustomObjectRecords | GET | Records of a custom object (filter via query params like field name+operator). |
Update a recordupdateCustomObjectRecord | PUT | Change a custom object record. |
Email11
Create a mailboxcreateMailbox | POST | Add a support mailbox (Freshdesk or custom). |
Delete a mailboxdeleteMailbox | DELETE | Remove a mailbox. |
Get a mailboxgetMailbox | GET | One mailbox. |
Get an email configgetEmailConfig | GET | One email config. |
List email configslistEmailConfigs | GET | All email configs. |
List mailboxeslistMailboxes | GET | All mailboxes. |
Update a mailboxupdateMailbox | PUT | Change a mailbox. |
Update automatic BCCupdateBccEmails | PUT | Change automatic BCC emails. |
Update mailbox settingsupdateMailboxSettings | PUT | Change global mailbox settings. |
View automatic BCCgetBccEmails | GET | Automatic BCC email settings. |
View mailbox settingsgetMailboxSettings | GET | Global mailbox settings. |
Forum27
Check forum followcheckForumFollow | GET | Whether a user follows a forum. |
Check topic followcheckTopicFollow | GET | Whether a user follows a topic. |
Create a commentcreateComment | POST | Comment on a topic. |
Create a forumcreateForum | POST | Add a forum to a category. |
Create a topiccreateTopic | POST | Start a topic in a forum. |
Create forum categorycreateForumCategory | POST | Add a forum category. |
Delete a commentdeleteComment | DELETE | Remove a comment. |
Delete a forumdeleteForum | DELETE | Remove a forum. |
Delete a topicdeleteTopic | DELETE | Remove a topic. |
Delete forum categorydeleteForumCategory | DELETE | Remove a forum category. |
Follow a forumfollowForum | POST | Follow a forum for a user. |
Follow a topicfollowTopic | POST | Follow a topic for a user. |
Get a forumgetForum | GET | One forum. |
Get a topicgetTopic | GET | One topic. |
Get forum categorygetForumCategory | GET | One forum category. |
List category forumslistCategoryForums | GET | Forums in a category. |
List followed topicslistFollowedTopics | GET | Topics a user follows. |
List forum categorieslistForumCategories | GET | All forum categories. |
List forum topicslistForumTopics | GET | Topics in a forum. |
List participated topicslistParticipatedTopics | GET | Topics a user participated in. |
List topic commentslistTopicComments | GET | Comments on a topic. |
Unfollow a forumunfollowForum | DELETE | Stop following a forum. |
Unfollow a topicunfollowTopic | DELETE | Stop following a topic. |
Update a commentupdateComment | PUT | Edit a comment. |
Update a forumupdateForum | PUT | Change a forum. |
Update a topicupdateTopic | PUT | Change a topic. |
Update forum categoryupdateForumCategory | PUT | Change a forum category. |
Group12
Add/remove group agentsmodifyGroupAgents | PATCH | Add or remove agents in a group. |
Create a groupcreateGroup | POST | Add a group (legacy route). |
Create a group (admin)createAdminGroup | POST | Add a support or field agent group. |
Delete a groupdeleteGroup | DELETE | Remove a group. |
Delete a group (admin)deleteAdminGroup | DELETE | Remove a group via the admin route. |
Get a groupgetGroup | GET | One group. |
Get a group (admin)getAdminGroup | GET | One group via the admin route. |
List group agentslistGroupAgents | GET | Agents in a group. |
List groupslistGroups | GET | All groups. |
List groups (admin)listAdminGroups | GET | All groups via the admin route. |
Update a groupupdateGroup | PUT | Change a group. |
Update a group (admin)updateAdminGroup | PUT | Change a group via the admin route. |
Product2
Get a productgetProduct | GET | One product. |
List productslistProducts | GET | All products. |
Role2
Get a rolegetRole | GET | One role. |
List roleslistRoles | GET | All roles. |
Skill5
Create a skillcreateSkill | POST | Add a routing skill with conditions. |
Delete a skilldeleteSkill | DELETE | Remove a skill. |
Get a skillgetSkill | GET | One skill. |
List skillslistSkills | GET | All skills. |
Update a skillupdateSkill | PUT | Change a skill's conditions or agents. |
SLA3
Create an SLA policycreateSlaPolicy | POST | Add an SLA policy with targets and conditions. |
List SLA policieslistSlaPolicies | GET | All SLA policies. |
Update an SLA policyupdateSlaPolicy | PUT | Change an SLA policy. |
Solution30
Create an articlecreateArticle | POST | Add an article to a folder (status 1 draft / 2 published). |
Create solution categorycreateSolutionCategory | POST | Add a knowledge-base category. |
Create solution foldercreateSolutionFolder | POST | Add a folder to a category. |
Delete an articledeleteArticle | DELETE | Remove an article. |
Delete solution categorydeleteSolutionCategory | DELETE | Remove a category. |
Delete solution folderdeleteSolutionFolder | DELETE | Remove a folder. |
Get an articlegetArticle | GET | One article. |
Get article translationgetArticleTranslation | GET | An article in a language. |
Get category translationgetSolutionCategoryTranslation | GET | A category in a language. |
Get folder translationgetSolutionFolderTranslation | GET | A folder in a language. |
Get solution categorygetSolutionCategory | GET | One category. |
Get solution foldergetSolutionFolder | GET | One folder. |
List articles (language)listFolderArticlesTranslated | GET | Folder articles for a language. |
List categories (language)listSolutionCategoriesTranslated | GET | All categories for a language. |
List category folderslistCategoryFolders | GET | Folders in a category. |
List folder articleslistFolderArticles | GET | Articles in a folder. |
List folders (language)listCategoryFoldersTranslated | GET | Folders in a category for a language. |
List solution categorieslistSolutionCategories | GET | All categories. |
List subfolderslistSubfolders | GET | Subfolders of a folder. |
List subfolders (language)listSubfoldersTranslated | GET | Subfolders for a language. |
Search articlessearchArticles | GET | Search knowledge-base articles. |
Translate articlecreateArticleTranslation | POST | Add an article translation. |
Translate categorycreateSolutionCategoryTranslation | POST | Add a category translation. |
Translate foldercreateSolutionFolderTranslation | POST | Add a folder translation. |
Update an articleupdateArticle | PUT | Change an article. |
Update article translationupdateArticleTranslation | PUT | Change an article translation. |
Update category translationupdateSolutionCategoryTranslation | PUT | Change a category translation. |
Update folder translationupdateSolutionFolderTranslation | PUT | Change a folder translation. |
Update solution categoryupdateSolutionCategory | PUT | Change a category. |
Update solution folderupdateSolutionFolder | PUT | Change a folder. |
Survey7
Create satisfaction ratingcreateSatisfactionRating | POST | Add a satisfaction rating to a ticket. |
Create survey responsecreateSurveyResponse | POST | Submit answers to a survey for a ticket. |
List CSAT surveyslistCsatSurveys | GET | Customer-satisfaction surveys. |
List satisfaction ratingslistSatisfactionRatings | GET | All satisfaction ratings. |
List survey responseslistSurveyResponses | GET | Responses to a survey. |
List surveys (legacy)listSurveys | GET | Legacy surveys list. |
Ticket satisfaction ratingslistTicketSatisfactionRatings | GET | Satisfaction ratings on a ticket. |
Ticket33
Add Ticket User AccessaddTicketUserAccess | POST | Add Ticket User Access |
Add watcheraddTicketWatcher | POST | Add watcher |
Add watcher to multiple ticketsaddWatcherToTickets | PUT | Add watcher to multiple tickets |
Bulk delete ticketsbulkDeleteTickets | POST | Delete several tickets. |
Bulk update ticketsbulkUpdateTickets | POST | Update several tickets, optionally with a bulk reply. |
Create a ticketcreateTicket | POST | Create a ticket (attachments require the vendor's multipart variant - stated gap). |
Create a ticket with attachmentscreateTicketWithAttachments | POST | Create a ticket (attachments require the vendor's multipart variant - stated gap). |
Create an outbound email with attachmentscreateOutboundEmailWithAttachments | POST | Open a ticket by sending an outbound email. |
Create outbound emailcreateOutboundEmail | POST | Open a ticket by sending an outbound email. |
Delete a ticketdeleteTicket | DELETE | Move a ticket to trash. |
Delete an Archive TicketdeleteArchivedTicket | DELETE | Delete an Archive Ticket |
Delete an attachmentdeleteAttachment | DELETE | Delete an attachment by ID. |
Delete SummarydeleteTicketSummary | DELETE | Delete Summary |
Filter ticketsfilterTickets | GET | Query tickets with the filter query language. |
Forward a ticketforwardTicket | POST | Forward a ticket to external email addresses. |
Get a ticketgetTicket | GET | One ticket; use include to embed stats/conversations/requester/company. |
Get Associated TicketsgetAssociatedTickets | GET | Get Associated Tickets |
Get Prime Association of a TicketgetPrimeTicketAssociation | GET | Get Prime Association of a Ticket |
Get Ticket User AccessgetTicketUserAccess | GET | Get Ticket User Access |
List All Conversations of an Archive TicketlistArchivedTicketConversations | GET | List All Conversations of an Archive Ticket |
List all watcherslistTicketWatchers | GET | List all watchers |
List ticketslistTickets | GET | Tickets with filter/sort/embed options. |
Merge ticketsmergeTickets | PUT | Merge related tickets into a primary ticket. |
Remove Ticket User AccessremoveTicketUserAccess | DELETE | Remove Ticket User Access |
Remove watcherremoveTicketWatcher | PUT | Remove watcher |
Remove watcher from multiple ticketsremoveWatcherFromTickets | PUT | Remove watcher from multiple tickets |
Restore a ticketrestoreTicket | PUT | Restore a deleted ticket. |
Update a ticketupdateTicket | PUT | Update a ticket's properties. |
Update a ticket with attachmentsupdateTicketWithAttachments | PUT | Update a ticket's properties. |
Update SummaryupdateTicketSummary | PUT | Update Summary |
Update Ticket User AccessupdateTicketUserAccess | PATCH | Update Ticket User Access |
View an Archive TicketgetArchivedTicket | GET | View an Archive Ticket |
View SummarygetTicketSummary | GET | View Summary |
Ticket Field11
Create a sectioncreateSection | POST | Add a section shown for chosen dropdown values. |
Create a ticket fieldcreateTicketField | POST | Add a custom ticket field. |
Delete a sectiondeleteSection | DELETE | Remove a section. |
Delete a ticket fielddeleteTicketField | DELETE | Remove a custom ticket field. |
Get a sectiongetSection | GET | One section. |
Get a ticket fieldgetTicketField | GET | One ticket field. |
List field sectionslistSections | GET | Sections on a dropdown ticket field. |
List ticket fieldslistTicketFields | GET | All ticket fields (legacy route). |
List ticket fields (admin)listAdminTicketFields | GET | All ticket fields via the admin route. |
Update a sectionupdateSection | PUT | Change a section's label or choices. |
Update a ticket fieldupdateTicketField | PUT | Change a ticket field. |
Ticket Form9
Clone a ticket formcloneTicketForm | GET | Duplicate a ticket form. |
Create a ticket formcreateTicketForm | POST | Create a ticket form with fields. |
Delete a form fielddeleteTicketFormField | DELETE | Remove a field from a ticket form. |
Delete a ticket formdeleteTicketForm | DELETE | Remove a ticket form. |
Get a form fieldgetTicketFormField | GET | One field on a ticket form. |
Get a ticket formgetTicketForm | GET | One ticket form. |
List ticket formslistTicketForms | GET | All ticket forms. |
Update a form fieldupdateTicketFormField | POST | Change a field on a ticket form. |
Update a ticket formupdateTicketForm | PUT | Change a ticket form. |
Time Entry6
Create a time entrycreateTimeEntry | POST | Log time on a ticket. |
Delete a time entrydeleteTimeEntry | DELETE | Remove a time entry. |
List ticket time entrieslistTicketTimeEntries | GET | Time entries on a ticket. |
List time entrieslistTimeEntries | GET | Time entries with agent/billable filters. |
Start/stop timertoggleTimer | PUT | Toggle the timer on a time entry. |
Update a time entryupdateTimeEntry | PUT | Change a time entry. |