> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Freshdesk

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* Show me every ticket open more than 48 hours without a reply.
* Reassign all `priority:urgent` tickets from John (out today) to Maria.
* Pull the average first-response time across the support team for last week.

## Available Tools

#### get_agent

Get a specific Freshdesk agent by ID

#### get_current_agent

Get the currently authenticated Freshdesk agent

#### list_agents

List all Freshdesk agents with optional filtering by email, phone, or state

#### update_agent

Update a Freshdesk agent's signature, ticket scope, groups, or roles

#### get_company

Get a specific Freshdesk company by ID

#### list_companies

List all Freshdesk companies with pagination

#### create_company

Create a new Freshdesk company with name, domains, and other details

#### update_company

Update an existing Freshdesk company's name, domains, or other details

#### delete_company

Delete a Freshdesk company by ID

#### search_companies

Search Freshdesk companies using query string. Supported fields: domain, custom_fields

#### get_contact

Get a specific Freshdesk contact by ID

#### list_contacts

List Freshdesk contacts with optional filtering by email, phone, company, or state

#### create_contact

Create a new Freshdesk contact with name, email, phone, and other details

#### update_contact

Update an existing Freshdesk contact's name, email, phone, or other details

#### delete_contact

Delete a Freshdesk contact by ID (soft delete)

#### search_contacts

Search Freshdesk contacts using query string with filters like email, name, or company_id

#### list_conversations

List all conversations (notes and replies) for a Freshdesk ticket

#### create_note

Add a private or public note to a Freshdesk ticket

#### create_reply

Add a reply to a Freshdesk ticket that is sent to the requester

#### get_group

Get a specific Freshdesk group by ID

#### list_groups

List all Freshdesk groups with pagination

#### create_group

Create a new Freshdesk group with name, agents, and escalation settings

#### update_group

Update an existing Freshdesk group's name, agents, or escalation settings

#### delete_group

Delete a Freshdesk group by ID

#### get_ticket

Get a specific Freshdesk ticket by ID with optional includes for conversations, requester, company, or stats

#### list_tickets

List Freshdesk tickets with optional filtering by requester, email, company, status, or date

#### create_ticket

Create a new Freshdesk ticket with subject, description, requester email, priority, and status

#### update_ticket

Update an existing Freshdesk ticket's subject, description, status, priority, or assignment

#### delete_ticket

Delete a Freshdesk ticket by ID

#### search_tickets

Search Freshdesk tickets using query string with filters like status, priority, or created_at