# Freshdesk — Pipedream Connect

> Customer support software

- API slug: `freshdesk` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Help Desk & Support
- Website: https://freshdesk.com
- This page (HTML): https://pipedream.com/apps/freshdesk
- Tools: 57 actions · 4 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: freshdesk`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "freshdesk",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Note to Ticket:
const result = await mcp.callTool({
  name: "freshdesk-add-note-to-ticket",
  arguments: {
    ticketId: 10,
    body: "Note Body",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Freshdesk endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.example.com/v1/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vdjEvbWU?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "freshdesk-add-note-to-ticket",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    freshdesk: { authProvisionId: "apn_xxxxxxx" },
    ticketId: 10,
    body: "Note Body",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (57)

### `freshdesk-add-note-to-ticket` — Add Note to Ticket (Write)

Add a note or conversation to an existing ticket. See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/add-note-to-ticket.md

### `freshdesk-add-ticket-tags` — Add Ticket Tags (Write)

Add tags to a ticket (appends to existing tags). See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/add-ticket-tags.md

### `freshdesk-assign-ticket-to-agent` — Assign Ticket to Agent (Write)

Assign a Freshdesk ticket to a specific agent. See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/assign-ticket-to-agent.md

### `freshdesk-assign-ticket-to-group` — Assign Ticket to Group (Write)

Assign a Freshdesk ticket to a specific group See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/assign-ticket-to-group.md

### `freshdesk-close-ticket` — Close Ticket (Write)

Set a Freshdesk ticket's status to 'Closed'. See docs

Full schema: https://pipedream.com/apps/freshdesk/actions/close-ticket.md

### `freshdesk-create-company` — Create a Company (Write)

Create a company. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/create-company.md

### `freshdesk-create-contact` — Create a Contact (Write)

Create a contact. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/create-contact.md

### `freshdesk-create-reply` — Create a Reply (Write)

Create a reply to a ticket. See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/create-reply.md

### `freshdesk-create-thread` — Create a Thread (Write)

Create a thread to a ticket. See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/create-thread.md

### `freshdesk-create-ticket` — Create a Ticket (Write)

Create a ticket. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/create-ticket.md

### `freshdesk-create-agent` — Create Agent (Write)

Create an agent in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/create-agent.md

### `freshdesk-create-message-for-thread` — Create Message For Thread (Write)

Create message for a thread. See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/create-message-for-thread.md

### `freshdesk-create-solution-article` — Create Solution Article (Write)

Create a solution article in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/create-solution-article.md

### `freshdesk-create-ticket-field` — Create Ticket Field (Write)

Create a ticket field in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/create-ticket-field.md

### `freshdesk-delete-solution-article` — Delete Solution Article (Write)

Delete a solution article in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/delete-solution-article.md

### `freshdesk-delete-ticket` — Delete Ticket (Write)

Delete a ticket in Freshdesk. This is a soft delete, so the ticket can be restored later. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/delete-ticket.md

### `freshdesk-delete-ticket-summary` — Delete Ticket Summary (Write)

Delete the summary note for a ticket. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/delete-ticket-summary.md

### `freshdesk-download-attachment` — Download Attachment (Read-only)

Download an attachment from a ticket. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/download-attachment.md

### `freshdesk-forward-ticket` — Forward Ticket (Write)

Forward a ticket to an external email address. See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/forward-ticket.md

### `freshdesk-get-agent` — Get Agent (Read-only)

Retrieve a single agent by their ID. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/get-agent.md

### `freshdesk-get-canned-response` — Get Canned Response (Read-only)

View a Canned Response. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/get-canned-response.md

### `freshdesk-get-folder-canned-responses` — Get Canned Responses In A Folder (Read-only)

View all the details of canned responses in a folder. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/get-folder-canned-responses.md

### `freshdesk-get-contact` — Get Contact (Read-only)

Get a contact from Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/get-contact.md

### `freshdesk-get-solution-article` — Get Solution Article (Read-only)

Get a solution article in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/get-solution-article.md

### `freshdesk-get-ticket` — Get Ticket Details (Read-only)

Get details of a Ticket. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/get-ticket.md

### `freshdesk-list-agent-id-options` — List Agent Options (Read-only)

Retrieves available options for the Agent field.

Full schema: https://pipedream.com/apps/freshdesk/actions/list-agent-id-options.md

### `freshdesk-list-agents` — List Agents (Read-only)

List all agents in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/list-agents.md

### `freshdesk-list-folder-canned-responses` — List All Canned Responses In A Folder (Read-only)

View all canned responses in a folder. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/list-folder-canned-responses.md

### `freshdesk-list-all-folders` — List All Folders (Read-only)

View all the canned response folders. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/list-all-folders.md

### `freshdesk-list-canned-response-folder-id-options` — List Canned Response Folder ID Options (Read-only)

Retrieves available options for the Canned Response Folder ID field.

Full schema: https://pipedream.com/apps/freshdesk/actions/list-canned-response-folder-id-options.md

### `freshdesk-list-category-folders` — List Category Folders (Read-only)

List category folders in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/list-category-folders.md

### `freshdesk-list-company-id-options` — List Company ID Options (Read-only)

Retrieves available options for the Company ID field.

Full schema: https://pipedream.com/apps/freshdesk/actions/list-company-id-options.md

### `freshdesk-list-ticket-conversations` — List Conversations of a Ticket (Read-only)

List all conversations for a ticket. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/list-ticket-conversations.md

### `freshdesk-list-folder-articles` — List Folder Articles (Read-only)

List folder articles in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/list-folder-articles.md

### `freshdesk-list-from-email-options` — List From Email Options (Read-only)

Retrieves available options for the From Email field.

Full schema: https://pipedream.com/apps/freshdesk/actions/list-from-email-options.md

### `freshdesk-list-group-id-options` — List Group Options (Read-only)

Retrieves available options for the Group field.

Full schema: https://pipedream.com/apps/freshdesk/actions/list-group-id-options.md

### `freshdesk-list-role-ids-options` — List Role IDs Options (Read-only)

Retrieves available options for the Role IDs field.

Full schema: https://pipedream.com/apps/freshdesk/actions/list-role-ids-options.md

### `freshdesk-list-skill-ids-options` — List Skill IDs Options (Read-only)

Retrieves available options for the Skill IDs field.

Full schema: https://pipedream.com/apps/freshdesk/actions/list-skill-ids-options.md

### `freshdesk-list-solution-categories` — List Solution Categories (Read-only)

List solution categories in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/list-solution-categories.md

### `freshdesk-list-ticket-field-id-options` — List Ticket Field ID Options (Read-only)

Retrieves available options for the Ticket Field ID field.

Full schema: https://pipedream.com/apps/freshdesk/actions/list-ticket-field-id-options.md

### `freshdesk-list-ticket-fields` — List Ticket Fields (Read-only)

List all ticket fields in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/list-ticket-fields.md

### `freshdesk-list-ticket-id-options` — List Ticket ID Options (Read-only)

Retrieves available options for the Ticket ID field.

Full schema: https://pipedream.com/apps/freshdesk/actions/list-ticket-id-options.md

### `freshdesk-list-all-tickets` — List Tickets (Read-only)

Fetch up to 100 tickets according to the selected filters. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/list-all-tickets.md

### `freshdesk-remove-ticket-tags` — Remove Ticket Tags (Write)

Remove specific tags from a ticket. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/remove-ticket-tags.md

### `freshdesk-reply-to-forward` — Reply to Forward (Write)

Reply to a previously forwarded ticket email. See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/reply-to-forward.md

### `freshdesk-search-solution-article` — Search Solution Article (Read-only)

Search solution articles in Freshdesk by keyword. Returns matching articles with their category/folder hierarchy, metadata, and content. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/search-solution-article.md

### `freshdesk-search-tickets` — Search Tickets (Read-only)

Search for tickets in Freshdesk using a structured filter query. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/search-tickets.md

### `freshdesk-set-ticket-priority` — Set Ticket Priority (Write)

Update the priority of a ticket in Freshdesk See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/set-ticket-priority.md

### `freshdesk-set-ticket-status` — Set Ticket Status (Write)

Update the status of a ticket in Freshdesk See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/set-ticket-status.md

### `freshdesk-set-ticket-tags` — Set Ticket Tags (Write)

Set tags on a ticket (replaces all existing tags). See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/set-ticket-tags.md

### `freshdesk-update-ticket` — Update a Ticket (Write)

Update status, priority, subject, description, agent, group, etc. See the documentation.

Full schema: https://pipedream.com/apps/freshdesk/actions/update-ticket.md

### `freshdesk-update-agent` — Update Agent (Write)

Update an agent in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/update-agent.md

### `freshdesk-update-contact` — Update Contact (Write)

Update a contact in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/update-contact.md

### `freshdesk-update-solution-article` — Update Solution Article (Write)

Update a solution article in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/update-solution-article.md

### `freshdesk-update-ticket-field` — Update Ticket Field (Write)

Update a ticket field in Freshdesk. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/update-ticket-field.md

### `freshdesk-update-ticket-summary` — Update Ticket Summary (Write)

Create or update the summary note for a ticket. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/update-ticket-summary.md

### `freshdesk-view-ticket-summary` — View Ticket Summary (Read-only)

Get the summary note for a ticket. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/actions/view-ticket-summary.md

## Triggers (4)

### `freshdesk-contact-updated` — Contact Updated (Polling)

Emit new event when a contact is updated. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/triggers/contact-updated.md

### `freshdesk-new-contact` — New Contact Created (Polling)

Emit new event when a contact is created. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/triggers/new-contact.md

### `freshdesk-new-ticket` — New Ticket Created (Polling)

Emit new event when a ticket is created. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/triggers/new-ticket.md

### `freshdesk-ticket-updated` — Ticket Updated (Polling)

Emit new event when a ticket is updated. See the documentation

Full schema: https://pipedream.com/apps/freshdesk/triggers/ticket-updated.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt