freshdesk_get_contact

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

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

Get full contact details by ID including name, email, phone, company, address, and ticket history.

Parameters

NameTypeRequiredDescription
_apiKeystringyesFreshdesk API key
_domainstringyesFreshdesk subdomain
idnumberyesContact ID

Example call

Arguments

{
  "_apiKey": "your-freshdesk-api-key",
  "_domain": "mycompany",
  "id": 5678
}

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_get_contact","arguments":{"_apiKey":"your-freshdesk-api-key","_domain":"mycompany","id":5678}}}'

TypeScript (@pipeworx/sdk)

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

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

Response shape

FieldTypeDescription
idnumberContact ID
namestringContact name
emailstringContact email address
phonestring | nullContact phone number
company_idnumber | nullAssociated company ID
addressstring | nullContact address
created_atstringISO timestamp
updated_atstringISO timestamp
Full JSON Schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Contact ID"
    },
    "name": {
      "type": "string",
      "description": "Contact name"
    },
    "email": {
      "type": "string",
      "description": "Contact email address"
    },
    "phone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Contact phone number"
    },
    "company_id": {
      "type": [
        "number",
        "null"
      ],
      "description": "Associated company ID"
    },
    "address": {
      "type": [
        "string",
        "null"
      ],
      "description": "Contact address"
    },
    "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.

Regenerated from source · build September 22, 2026