Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Freshdesk

Scalekit connector
Open markdown

The Freshdesk connector lets your AI agent act in each user's Freshdesk account. Each user connects their own Freshdesk username and password once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 34 tools.

Tools
34
What they doRead · write · destructive
15 · 15 · 415 read15 write4 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Create the Freshdesk connection

    In AgentKit > Connections, create a Freshdesk connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • freshdesk_agent_getRetrieve details of a specific agent by ID, including their roles, groups, skills, ticket scope, and contact information.Read-only

    Get Agent

    Retrieve details of a specific agent by ID, including their roles, groups, skills, ticket scope, and contact information.

    Inputs

    agent_idnumberrequired
    ID of the agent to retrieve
  • freshdesk_agents_listRetrieve a list of agents from Freshdesk with filtering options.Read-only

    List Agents

    Retrieve a list of agents from Freshdesk with filtering options. Returns agent details including IDs, contact information, roles, and availability status. Supports pagination with up to 100 agents per page.

    Inputs

    emailstring
    Filter agents by email address
    mobilestring
    Filter agents by mobile number
    pagenumber
    Page number for pagination (starts from 1)
    per_pagenumber
    Number of agents per page (max 100)
    phonestring
    Filter agents by phone number
    statestring
    Filter agents by state (fulltime or occasional)
  • freshdesk_canned_response_folders_listRetrieve all canned response folders, each including the canned responses stored inside it.Read-only

    List Canned Response Folders

    Retrieve all canned response folders, each including the canned responses stored inside it. Use a folder ID with Create Canned Response.

    Inputs

    This tool takes no inputs.

  • freshdesk_companies_listRetrieve a paginated list of all companies in the Freshdesk account.Read-only

    List Companies

    Retrieve a paginated list of all companies in the Freshdesk account.

    Inputs

    pagenumber
    Page number for pagination (starts from 1)
    per_pagenumber
    Number of companies per page (max 100)
  • freshdesk_company_getRetrieve details of a specific company by ID, including custom fields, domains, and health score.Read-only

    Get Company

    Retrieve details of a specific company by ID, including custom fields, domains, and health score.

    Inputs

    company_idnumberrequired
    ID of the company to retrieve
  • freshdesk_contact_getRetrieve details of a specific contact by ID, including custom fields and associated company.Read-only

    Get Contact

    Retrieve details of a specific contact by ID, including custom fields and associated company.

    Inputs

    contact_idnumberrequired
    ID of the contact to retrieve
  • freshdesk_contacts_listRetrieve a list of contacts with filtering and pagination.Read-only

    List Contacts

    Retrieve a list of contacts with filtering and pagination. Supports filtering by email, phone, mobile, company, and state.

    Inputs

    company_idnumber
    Filter by company ID
    emailstring
    Filter by contact email
    mobilestring
    Filter by mobile number
    pagenumber
    Page number for pagination (starts from 1)
    per_pagenumber
    Number of contacts per page (max 100)
    phonestring
    Filter by phone number
    statestring
    Filter by contact state
    updated_sincestring
    Filter contacts updated since this timestamp (ISO 8601)
  • freshdesk_groups_listRetrieve a list of all agent groups in Freshdesk, including group membership and escalation settings.Read-only

    List Groups

    Retrieve a list of all agent groups in Freshdesk, including group membership and escalation settings.

    Inputs

    This tool takes no inputs.

Workflows

Proxy API call

Don’t worry about your Freshdesk domain in the path. Scalekit automatically resolves {{domain}} from the connected account’s configuration and constructs the full URL for you. For example, if your Freshdesk domain is mycompany.freshdesk.com, a request with path="/v2/agents/me" will be sent to https://mycompany.freshdesk.com/api/v2/agents/me automatically.

const result = await actions.request({
  connectionName: 'freshdesk',
  identifier: 'user_123',
  path: '/v2/agents/me',
  method: 'GET',
});
console.log(result);
Execute a tool
const result = await actions.executeTool({
  connector: 'freshdesk',
  identifier: 'user_123',
  toolName: 'freshdesk_agent_create',
  toolInput: {},
});
console.log(result);
All 16 in Customer Support