Skip to main content

​
Freshdesk

In one line: Connect Freshdesk so your UnleashX agent can create, update, and triage support tickets, look up contacts and companies, and react to new tickets — all in plain language.

​
1. Overview

Freshdesk is Freshworks’ cloud-based customer support and help desk platform. It’s where your support tickets, contacts, and companies live — the system of record for customer conversations and the SLAs that keep them on track. Once connected to UnleashX, your agent can create, read, update, and delete tickets, list and create contacts and companies, and react to new or updated tickets in a workflow. It works against your live Freshdesk account using your API key, so it respects your account’s data and settings. Connecting Freshdesk to UnleashX means your help desk stays current as you talk. Instead of opening Freshdesk to raise a ticket or update a contact, you tell your agent and it makes the change — and workflows can respond the moment a new ticket arrives.

​
2. What you’ll need

  • A Freshdesk account and your Freshdesk domain (e.g. yourcompany.freshdesk.com).
  • Your Freshdesk API key (see Section 3).
  • An UnleashX account with access to Data Connectors.
You paste two values: your Freshdesk domain and your API key. UnleashX sends the key to your domain using HTTP basic authentication.
Your Freshdesk role determines what the API key can do. If your Freshdesk user can’t delete tickets or manage contacts, the agent can’t either. Ask an admin to adjust your role if an action is denied.

​
3. Get your credentials

Freshdesk MCP authenticates with your domain plus an API key tied to your Freshdesk user. You copy both once and paste them into UnleashX. There’s no OAuth flow and nothing to install.
1

Sign in to Freshdesk

Go to your Freshdesk account and sign in. Your domain is the address in your browser — for example yourcompany.freshdesk.com. UnleashX needs this so it knows which Freshdesk account to talk to.
2

Open your profile settings

Click your profile picture in the top-right corner, then select Profile settings.
3

Copy Your API Key

On the profile settings page, find Your API Key in the right-hand panel and copy it. Treat it like a password — it grants access to your account’s API with your permissions.
4

Paste both into UnleashX

Head to Data Connectors → Freshdesk in UnleashX and paste both your domain and your API key (full walkthrough in Section 4). UnleashX validates them immediately, so you’ll know right away if either was copied incorrectly.
Your API key grants access to your Freshdesk account. Treat it like a password:
  • Never commit it to git, paste it in a ticket, or share it in chat.
  • If it’s ever exposed, reset it from Profile settings in Freshdesk — the old key stops working, so reconnect UnleashX with the new value.

​
Permissions this key grants UnleashX

​
4. Connect on UnleashX

1

Open your agent

Go to https://www.tryunleashx.com and open the agent you want to connect.
2

Open Data Connectors

Inside the agent, go to Data Connectors.
3

Find Freshdesk

Locate Freshdesk and click Connect (or Add / Configure).
4

Enter your domain and API key

Paste your Freshdesk domain and your API key, then click Connect.
5

Confirm success

UnleashX validates the credentials and the Freshdesk connector shows a Connected badge.

​
Use Freshdesk in a Workflow

Once connected, you can add Freshdesk to any automation from the Workflows builder. Its triggers and tools appear in the Apps panel, marked with an MCP badge.
1

Add a trigger node

Open Workflows → New Workflow. On the canvas, click + Add Trigger. In the Paths panel, open the Apps tab and select Freshdesk — its Triggers are listed underneath. Use the search box if you have many connectors.
2

Add an action node

Click the + below any node to add a step, then pick Freshdesk again — this time the panel lists its Actions.
3

Configure the step

Fill in the fields for the trigger or action you picked. Required fields are marked with a red asterisk (*).
4

Add or select your account

Under Selected account, choose an already-connected account, or click Add Account to connect one now.
5

Save and test

Click Save. Use Test to verify the step, then toggle Publish when the workflow is ready.
The steps are the same for every connector. For the full workflow builder guide, see Using MCP in Workflows.

​
5. Available tools

​
Available triggers

​
6. Example usage

“Open a high-priority ticket for acme@customer.com about a failed login and assign it to the support queue.” → Runs Create Ticket with the requester, subject, and high priority set. “When a new ticket comes in tagged ‘billing’, create a contact for the requester if we don’t have one.” → Uses the On New Ticket trigger, then runs Create Contact for the requester in the workflow.

​
7. Permissions & data access

UnleashX can:
  • Read and list tickets, contacts, and companies.
  • Create and update tickets, and create contacts and companies.
  • Delete tickets where your role allows (this tool is clearly marked ⚠️).
  • React to new and updated tickets and notes via workflow triggers.
UnleashX cannot:
  • Access Freshdesk accounts other than the domain you connected.
  • Do anything your Freshdesk role doesn’t permit.
  • Change your Freshdesk account password or admin settings.
To disconnect: In UnleashX, open Data Connectors → Freshdesk → Disconnect. Then reset the API key in Freshdesk under Profile settings. Disconnecting and resetting removes access immediately.

​
8. Troubleshooting

For general MCP issues, see /mcp/integrations.

​
9. Frequently asked questions

Is my support data stored by UnleashX? No. UnleashX reads and writes your records live through the Freshdesk API per request; it doesn’t keep a copy of your tickets or contacts. Why do I need both a domain and an API key? The API key authenticates you, and the domain tells UnleashX which Freshdesk account to reach. Both are needed for the connection to work. Can the agent really delete tickets? Yes — Delete Ticket (marked ⚠️) makes a permanent change in Freshdesk, and only works if your role allows it. Use it deliberately. Where do the triggers fire? Triggers like On New Ticket run inside Workflows — they start an automation the moment a matching event happens in Freshdesk.

​
10. References