`freshdesk_list_tickets`

Pack: freshdesk · Endpoint: https://gateway.pipeworx.io/freshdesk/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/freshdesk_list_tickets for the schema, then POST the same URL with its arguments for the data.

List support tickets filtered by status (e.g., “open”, “closed”) and priority (e.g., “1” for urgent). Returns ticket ID, subject, status, priority, and requester.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Freshdesk API key
`_domain`	string	yes	Freshdesk subdomain (e.g., “mycompany” for mycompany.freshdesk.com)
`page`	number	no	Page number for pagination (default 1)
`per_page`	number	no	Results per page (default 30, max 100)
`filter`	string	no	Predefined filter: new_and_my_open, watching, spam, deleted (default: new_and_my_open)
`order_by`	string	no	Sort by: created_at, due_by, updated_at, status (default: created_at)
`order_type`	string	no	Sort order: asc or desc (default: desc)

Example call

Arguments

{
  "_apiKey": "your-freshdesk-api-key",
  "_domain": "mycompany",
  "filter": "new_and_my_open"
}

curl

curl -X POST https://gateway.pipeworx.io/freshdesk/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"freshdesk_list_tickets","arguments":{"_apiKey":"your-freshdesk-api-key","_domain":"mycompany","filter":"new_and_my_open"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('freshdesk_list_tickets', {
  "_apiKey": "your-freshdesk-api-key",
  "_domain": "mycompany",
  "filter": "new_and_my_open"
});

More examples

{
  "_apiKey": "your-freshdesk-api-key",
  "_domain": "mycompany",
  "page": 2,
  "per_page": 50,
  "order_by": "updated_at",
  "order_type": "desc"
}

Response shape

Field	Type	Description
`tickets`	array	Array of ticket objects

Full JSON Schema

{
  "type": "object",
  "properties": {
    "tickets": {
      "type": "array",
      "description": "Array of ticket objects",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "Ticket ID"
          },
          "subject": {
            "type": "string",
            "description": "Ticket subject"
          },
          "status": {
            "type": "number",
            "description": "Ticket status code"
          },
          "priority": {
            "type": "number",
            "description": "Ticket priority level"
          },
          "requester_id": {
            "type": "number",
            "description": "Requester contact ID"
          },
          "created_at": {
            "type": "string",
            "description": "ISO timestamp"
          },
          "updated_at": {
            "type": "string",
            "description": "ISO timestamp"
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "freshdesk": {
      "url": "https://gateway.pipeworx.io/freshdesk/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

freshdesk_list_tickets