π Quickstart
Connect to Freshdesk with Nango and see data flow in 2 minutes.1
Create the integration
In Nango (free signup), go to Integrations -> Configure New Integration -> Freshdesk.
2
Authorize Freshdesk
Go to Connections -> Add Test Connection -> Authorize, then enter your Freshdesk credentials. Later, youβll let your users do the same directly from your app.
3
Call the Freshdesk API
Letβs make your first request to the Freshdesk API (fetch a list of tickets). Replace the placeholders below with your Environment API key, integration ID, and connection ID:Or fetch credentials with the Node SDK or API.β
Youβre connected! Check the Logs tab in Nango to inspect requests.
- cURL
- Node
curl "https://api.nango.dev/proxy/api/v2/tickets" \
-H "Authorization: Bearer <NANGO-API-KEY>" \
-H "Provider-Config-Key: <INTEGRATION-ID>" \
-H "Connection-Id: <CONNECTION-ID>"
Install Nangoβs backend SDK with
npm i @nangohq/node. Then run:import { Nango } from '@nangohq/node';
const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });
const res = await nango.get({
endpoint: '/api/v2/tickets',
providerConfigKey: '<INTEGRATION-ID>',
connectionId: '<CONNECTION-ID>'
});
console.log(res.data);
4
Implement Nango in your app
Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.
π Freshdesk Integration Guides
Nango maintained guides for common use cases.- How do I link my Freshdesk account?
Learn how to obtain your Freshdesk credentials and link your account
π§© Pre-built syncs & actions for Freshdesk
Enable them in your dashboard. Extend and customize to fit your needs.Others
| Function name | Description | Type | Source code |
|---|---|---|---|
add-ticket-note | Add a private or public note to a Freshdesk ticket. | Action | π Github |
add-ticket-watcher | Add a watcher (agent) to a Freshdesk ticket. | Action | π Github |
bulk-delete-tickets | Delete multiple Freshdesk tickets in a single call. | Action | π Github |
bulk-update-tickets | Update multiple Freshdesk tickets in a single call. | Action | π Github |
create-agent | Create a agent in Freshdesk. | Action | π Github |
create-canned-response-folder | Create a canned response folder in Freshdesk. | Action | π Github |
create-canned-response | Create a canned response in Freshdesk. | Action | π Github |
create-company-field | Create a company field in Freshdesk. | Action | π Github |
create-company | Create a company in Freshdesk. | Action | π Github |
create-contact-field | Create a contact field in Freshdesk. | Action | π Github |
create-contact | Create a contact in Freshdesk. | Action | π Github |
create-forum-category | Create a discussion forum category in Freshdesk. | Action | π Github |
create-forum | Create a discussion forum in Freshdesk. | Action | π Github |
create-group | Create a group in Freshdesk. | Action | π Github |
create-sla-policy | Create an SLA policy in Freshdesk. | Action | π Github |
create-solution-article | Create a solution article in Freshdesk. | Action | π Github |
create-solution-category | Create a solutions category in Freshdesk. | Action | π Github |
create-solution-folder | Create a solutions folder in Freshdesk. | Action | π Github |
create-ticket-field | Create a ticket field in Freshdesk. | Action | π Github |
create-ticket | Create a ticket in Freshdesk. | Action | π Github |
create-topic | Create a discussion forum topic in Freshdesk. | Action | π Github |
delete-agent | Delete or archive a agent in Freshdesk. | Action | π Github |
delete-company-field | Delete a company field in Freshdesk. | Action | π Github |
delete-company | Permanently delete a company in Freshdesk. This cannot be undone. | Action | π Github |
delete-contact-field | Delete a contact field in Freshdesk. | Action | π Github |
delete-contact | Delete or archive a contact in Freshdesk. | Action | π Github |
delete-forum-category | Delete a discussion forum category in Freshdesk | Action | π Github |
delete-forum | Delete a discussion forum in Freshdesk. | Action | π Github |
delete-group | Permanently delete a group in Freshdesk. This cannot be undone. | Action | π Github |
delete-solution-article | Permanently delete a solution article and all of its translated versions in Freshdesk. This cannot be undone. | Action | π Github |
delete-solution-category | Delete a solutions category in Freshdesk. | Action | π Github |
delete-solution-folder | Delete a solutions folder in Freshdesk. | Action | π Github |
delete-ticket-field | Delete a ticket field in Freshdesk. | Action | π Github |
delete-ticket | Delete or archive a ticket in Freshdesk. | Action | π Github |
delete-topic | Delete a discussion forum topic in Freshdesk. | Action | π Github |
forward-ticket | Forward a Freshdesk ticket to one or more email addresses. | Action | π Github |
get-agent | Retrieve a single agent from Freshdesk. | Action | π Github |
get-canned-response | Retrieve a single canned response from Freshdesk. | Action | π Github |
get-company | Retrieve a single company from Freshdesk. | Action | π Github |
get-contact | Retrieve a single contact from Freshdesk. | Action | π Github |
get-forum-category | Retrieve a single discussion forum category from Freshdesk | Action | π Github |
get-forum | Retrieve a single discussion forum from Freshdesk. | Action | π Github |
get-group | Retrieve a single group from Freshdesk | Action | π Github |
get-role | Retrieve a single agent role from Freshdesk. | Action | π Github |
get-solution-article | Retrieve a single solution article from Freshdesk. | Action | π Github |
get-solution-category | Retrieve a single solutions category from Freshdesk. | Action | π Github |
get-solution-folder | Retrieve a single solutions folder from Freshdesk. | Action | π Github |
get-ticket-field | Retrieve a single ticket field from Freshdesk. | Action | π Github |
get-ticket | Retrieve a single ticket from Freshdesk. | Action | π Github |
get-topic | Retrieve a single discussion forum topic from Freshdesk. | Action | π Github |
list-agents | List agents from Freshdesk. | Action | π Github |
list-companies | List companies from Freshdesk. | Action | π Github |
list-contacts | List contacts from Freshdesk. | Action | π Github |
list-groups | List groups from Freshdesk. | Action | π Github |
list-solution-articles | List solution articles from Freshdesk. | Action | π Github |
list-tickets | List tickets from Freshdesk. | Action | π Github |
make-contact-agent | Convert a Freshdesk contact into an agent. | Action | π Github |
merge-contacts | Merge one or more Freshdesk contacts into a primary contact. | Action | π Github |
merge-tickets | Merge one or more Freshdesk tickets. | Action | π Github |
reply-to-ticket | Reply to a Freshdesk ticket. | Action | π Github |
restore-contact | Restore a soft-deleted Freshdesk contact. | Action | π Github |
restore-ticket | Restore a deleted Freshdesk ticket. | Action | π Github |
send-contact-invite | Send a portal invitation email to a Freshdesk contact | Action | π Github |
update-agent | Update a agent in Freshdesk. | Action | π Github |
update-canned-response-folder | Update a canned response folder in Freshdesk. | Action | π Github |
update-canned-response | Update a canned response in Freshdesk. | Action | π Github |
update-company-field | Update a company field in Freshdesk. | Action | π Github |
update-company | Update a company in Freshdesk. | Action | π Github |
update-contact-field | Update a contact field in Freshdesk. | Action | π Github |
update-contact | Update a contact in Freshdesk. | Action | π Github |
update-forum-category | Update a discussion forum category in Freshdesk. | Action | π Github |
update-forum | Update a discussion forum in Freshdesk. | Action | π Github |
update-group | Update a group in Freshdesk. | Action | π Github |
update-sla-policy | Update an SLA policy in Freshdesk. | Action | π Github |
update-solution-article | Update a solution article in Freshdesk. | Action | π Github |
update-solution-category | Update a solutions category in Freshdesk. | Action | π Github |
update-solution-folder | Update a solutions folder in Freshdesk. | Action | π Github |
update-ticket-field | Update a ticket field in Freshdesk. | Action | π Github |
update-ticket | Update a ticket in Freshdesk. | Action | π Github |
update-topic | Update a discussion forum topic in Freshdesk. | Action | π Github |
agents | Sync agents from Freshdesk. | Sync | π Github |
articles | Recursively fetches a list of solution articles. | Sync | π Github |
business-hours | Sync business hours configurations from Freshdesk | Sync | π Github |
canned-responses | Recursively fetches canned responses from Freshdesk canned response folders. | Sync | π Github |
companies | Sync companies from Freshdesk. | Sync | π Github |
company-fields | Sync company field definitions from Freshdesk. | Sync | π Github |
contact-fields | Sync contact field definitions from Freshdesk. | Sync | π Github |
contacts | Sync contacts from Freshdesk. | Sync | π Github |
forum-topics | Recursively fetches discussion forum topics from Freshdesk (categories -> forums -> topics), mirroring the categories -> folders -> articles traversal used by the articles sync. | Sync | π Github |
groups | Sync groups from Freshdesk | Sync | π Github |
roles | Sync agent roles from Freshdesk. | Sync | π Github |
satisfaction-ratings | Sync ticket satisfaction ratings from Freshdesk. | Sync | π Github |
sla-policies | Sync SLA policies from Freshdesk | Sync | π Github |
ticket-fields | Sync ticket field definitions from Freshdesk. | Sync | π Github |
tickets | Sync tickets from Freshdesk | Sync | π Github |
time-entries | Sync ticket time entries from Freshdesk. | Sync | π Github |