# Manage Freshdesk tickets with the Freshdesk pipe

> Install the Freshdesk pipe with your helpdesk name and API key, then create and update tickets, contacts and agents from your app.

Source: https://tadabase.com/docs/pipes/freshdesk-pipe  
Status: Verified Nov 17, 2026. Checked against the current product

The Freshdesk pipe calls version 2 of the Freshdesk API for your helpdesk. Use it to open tickets from your app, keep contacts in step with your records, and manage agents.

![The Freshdesk pipe's install window with its list of available calls and the Install button](https://tadabase.com/docs-shots/pipes-freshdesk-pipe-install.webp)

## What you need from Freshdesk

- **Your helpdesk name**: the part before `.freshdesk.com` in your helpdesk address. For `acme.freshdesk.com` it is `acme`.
- **Your API key**: in Freshdesk, click your profile picture, open **Profile settings**, and copy the API key shown there. Calls made with it act as you, with your Freshdesk permissions.

## Install the pipe

1. **Open Pipes** In the builder, click the **Pipes** icon in the left menu. The **All Pipes** page lists every pipe you can install.
2. **Find the pipe** Type `Freshdesk` in the **Search...** box and click the **Freshdesk** card. The window shows what the pipe does and its **Available Actions**: the calls it offers.
3. **Click Install** Click **Install**. If your plan does not include pipes, an upgrade button shows instead.
4. **Enter your details** Enter your key in **Freshdesk API Key** and your helpdesk name in **Freshdesk Domain Name**. Both are required. Click **Install**.

To change them later, open the installed pipe, click **Global Parameters**, change the value and click **Save**.

## Calls in the pipe

| Resource | Call | Parameters |
| --- | --- | --- |
| Tickets | **Create a Ticket** | Description, Subject, Email (required); Priority, Status |
| Tickets | **Create an Outbound Email** | Description, Subject, Email, Email Config ID; Priority, Status |
| Tickets | **View a Ticket** | Ticket ID |
| Tickets | **Update a Ticket** | Ticket ID, Priority, Status |
| Tickets | **Delete a Ticket** | Ticket ID |
| Tickets | **Restore a Ticket** | Ticket ID |
| Tickets | **Forward a Ticket** | Ticket ID, Body, To Emails |
| Tickets | **Add watcher** | Ticket ID, Agent ID |
| Tickets | **Remove watcher** | Ticket ID |
| Tickets | **View Email Config ID** | None (lists your email configurations, for Create an Outbound Email) |
| Contacts | **Create a Contact** | Name, Email, Phone |
| Contacts | **View a Contact** | Contact ID |
| Contacts | **Update a Contact** | Contact ID, Name, Email, Phone |
| Contacts | **Soft Delete a Contact** | Contact ID |
| Contacts | **Permanently Delete a Contact** | Contact ID |
| Agents | **Create an Agent** | Email, Name, Ticket Scope |
| Agents | **Update an Agent** | Agent ID, Email, Name, Ticket Scope |
| Agents | **Delete an Agent** | Agent ID |
| Agents | **Currently Authenticated Agent** | None (returns the agent whose API key the pipe uses) |

Priority and Status are numbers:

| Parameter | Values | Default |
| --- | --- | --- |
| Priority | 1 = Low, 2 = Medium, 3 = High, 4 = Urgent | 1 |
| Status | 2 = Open, 3 = Pending, 4 = Resolved, 5 = Closed | 2 |

## Use it in a workflow

You can run any call of an installed pipe from a workflow with the **Trigger Pipe** action, and use what it returns in later steps. Pipes can also run in other parts of your app, as described in [Using pipes](https://tadabase.com/docs/pipes/using-pipes).

Example: open a Freshdesk ticket when someone submits a support request in your app, and keep the ticket number.

1. **Add a Ticket ID field** In your Support Requests table, add a text field named Freshdesk Ticket ID.
2. **Start a workflow** Create a workflow that runs when a support request record is created.
3. **Add a Trigger Pipe step** Add the **Trigger Pipe** action and choose the Freshdesk pipe's **Create a Ticket** call in **Pipe Method**. Set **Subject**, **Description** and **Email** from the record, and **Priority** to a number from the table above.
4. **Save the ticket number** Add an **Update Record** step and set Freshdesk Ticket ID to the pipe's **Ticket ID** response.

## More from Freshdesk

For every field these calls accept and return, see the [Freshdesk API reference](https://developers.freshdesk.com/api/).
