freshdesk

Server path: /freshdesk | Type: Application | PCID required: Yes Tickets, contacts, and agents

Tools

Tool	Description
`freshdesk_create_ticket`	Create a new support ticket in Freshdesk
`freshdesk_get_ticket`	Retrieve a ticket by ID
`freshdesk_update_ticket`	Update an existing ticket
`freshdesk_list_tickets`	List tickets with optional filtering
`freshdesk_add_note`	Add a note to a ticket
`freshdesk_create_contact`	Create a new contact in Freshdesk
`freshdesk_get_contact`	Retrieve a contact by ID
`freshdesk_update_contact`	Update an existing contact
`freshdesk_create_company`	Create a new company in Freshdesk
`freshdesk_get_company`	Retrieve a company by ID
`freshdesk_search_tickets`	Search tickets using Freshdesk query language
`freshdesk_get_agents`	Get list of agents in Freshdesk
`freshdesk_get_groups`	Get list of agent groups
`freshdesk_get_time_entries`	Get time entries for tickets
`freshdesk_create_time_entry`	Create a time entry for a ticket

freshdesk_create_ticket

Create a new support ticket in Freshdesk Parameters:

Parameter	Type	Required	Default	Description
`subject`	string	Yes	—	Ticket subject
`description`	string	Yes	—	Ticket description
`email`	string	Yes	—	Requester email address
`priority`	number	No	`1`	Ticket priority (1=Low, 2=Medium, 3=High, 4=Urgent)
`status`	number	No	`2`	Ticket status (2=Open, 3=Pending, 4=Resolved, 5=Closed, 6=Waiting on Customer, 7=Waiting on Third Party)
`type`	string	No	—	Ticket type
`source`	number	No	`2`	Ticket source (1=Email, 2=Portal, 3=Phone, 5=Forum, 6=Twitter, 7=Chat, 9=Feedback Widget, 10=Outbound Email, 11=eCommerce)
`tags`	string[]	No	—	Tags for the ticket
`cc_emails`	string[]	No	—	CC email addresses
`custom_fields`	object	No	—	Custom field values
`attachments`	object[]	No	—	File attachments

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "subject": {
      "type": "string",
      "description": "Ticket subject"
    },
    "description": {
      "type": "string",
      "description": "Ticket description"
    },
    "email": {
      "type": "string",
      "description": "Requester email address"
    },
    "priority": {
      "type": "number",
      "default": 1,
      "description": "Ticket priority (1=Low, 2=Medium, 3=High, 4=Urgent)"
    },
    "status": {
      "type": "number",
      "default": 2,
      "description": "Ticket status (2=Open, 3=Pending, 4=Resolved, 5=Closed, 6=Waiting on Customer, 7=Waiting on Third Party)"
    },
    "type": {
      "type": "string",
      "description": "Ticket type"
    },
    "source": {
      "type": "number",
      "default": 2,
      "description": "Ticket source (1=Email, 2=Portal, 3=Phone, 5=Forum, 6=Twitter, 7=Chat, 9=Feedback Widget, 10=Outbound Email, 11=eCommerce)"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags for the ticket"
    },
    "cc_emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "CC email addresses"
    },
    "custom_fields": {
      "type": "object",
      "additionalProperties": true,
      "description": "Custom field values"
    },
    "attachments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Attachment filename"
          },
          "content": {
            "type": "string",
            "description": "Base64 encoded file content"
          },
          "content_type": {
            "type": "string",
            "description": "MIME type of the file"
          }
        }
      },
      "description": "File attachments"
    }
  },
  "required": [
    "PCID",
    "subject",
    "description",
    "email"
  ]
}

freshdesk_get_ticket

Retrieve a ticket by ID Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	string	Yes	—	Ticket ID to retrieve
`include`	string[]	No	—	Additional data to include in response

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "ticket_id": {
      "type": "string",
      "description": "Ticket ID to retrieve"
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "requester",
          "company",
          "stats"
        ]
      },
      "description": "Additional data to include in response"
    }
  },
  "required": [
    "PCID",
    "ticket_id"
  ]
}

freshdesk_update_ticket

Update an existing ticket Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	string	Yes	—	Ticket ID to update
`subject`	string	No	—	Updated subject
`description`	string	No	—	Updated description
`priority`	number	No	—	Updated priority (1=Low, 2=Medium, 3=High, 4=Urgent)
`status`	number	No	—	Updated status (2=Open, 3=Pending, 4=Resolved, 5=Closed, 6=Waiting on Customer, 7=Waiting on Third Party)
`type`	string	No	—	Updated type
`tags`	string[]	No	—	Updated tags
`custom_fields`	object	No	—	Updated custom field values

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "ticket_id": {
      "type": "string",
      "description": "Ticket ID to update"
    },
    "subject": {
      "type": "string",
      "description": "Updated subject"
    },
    "description": {
      "type": "string",
      "description": "Updated description"
    },
    "priority": {
      "type": "number",
      "description": "Updated priority (1=Low, 2=Medium, 3=High, 4=Urgent)"
    },
    "status": {
      "type": "number",
      "description": "Updated status (2=Open, 3=Pending, 4=Resolved, 5=Closed, 6=Waiting on Customer, 7=Waiting on Third Party)"
    },
    "type": {
      "type": "string",
      "description": "Updated type"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Updated tags"
    },
    "custom_fields": {
      "type": "object",
      "additionalProperties": true,
      "description": "Updated custom field values"
    }
  },
  "required": [
    "PCID",
    "ticket_id"
  ]
}

freshdesk_list_tickets

List tickets with optional filtering Parameters:

Parameter	Type	Required	Default	Description
`filter`	string	No	`"new_and_my_open"`	Predefined filter for tickets
`requester_id`	string	No	—	Filter by requester ID
`email`	string	No	—	Filter by requester email
`company_id`	string	No	—	Filter by company ID
`updated_since`	string	No	—	Filter by updated since timestamp (ISO format)
`page`	number	No	`1`	Page number for pagination
`per_page`	number	No	`30`	Tickets per page (1-100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "filter": {
      "type": "string",
      "enum": [
        "new_and_my_open",
        "watching",
        "spam",
        "deleted"
      ],
      "default": "new_and_my_open",
      "description": "Predefined filter for tickets"
    },
    "requester_id": {
      "type": "string",
      "description": "Filter by requester ID"
    },
    "email": {
      "type": "string",
      "description": "Filter by requester email"
    },
    "company_id": {
      "type": "string",
      "description": "Filter by company ID"
    },
    "updated_since": {
      "type": "string",
      "description": "Filter by updated since timestamp (ISO format)"
    },
    "page": {
      "type": "number",
      "default": 1,
      "description": "Page number for pagination"
    },
    "per_page": {
      "type": "number",
      "default": 30,
      "description": "Tickets per page (1-100)"
    }
  },
  "required": [
    "PCID"
  ]
}

freshdesk_add_note

Add a note to a ticket Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	string	Yes	—	Ticket ID to add note to
`body`	string	Yes	—	Note content
`private`	boolean	No	`false`	Whether the note is private
`notify_emails`	string[]	No	—	Email addresses to notify
`user_id`	string	No	—	User ID creating the note

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "ticket_id": {
      "type": "string",
      "description": "Ticket ID to add note to"
    },
    "body": {
      "type": "string",
      "description": "Note content"
    },
    "private": {
      "type": "boolean",
      "default": false,
      "description": "Whether the note is private"
    },
    "notify_emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses to notify"
    },
    "user_id": {
      "type": "string",
      "description": "User ID creating the note"
    }
  },
  "required": [
    "PCID",
    "ticket_id",
    "body"
  ]
}

freshdesk_create_contact

Create a new contact in Freshdesk Parameters:

Parameter	Type	Required	Default	Description
`name`	string	Yes	—	Contact name
`email`	string	Yes	—	Contact email address
`phone`	string	No	—	Contact phone number
`mobile`	string	No	—	Contact mobile number
`job_title`	string	No	—	Contact job title
`company_id`	string	No	—	Associated company ID
`address`	string	No	—	Contact address
`description`	string	No	—	Contact description
`tags`	string[]	No	—	Tags for the contact
`custom_fields`	object	No	—	Custom field values

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "name": {
      "type": "string",
      "description": "Contact name"
    },
    "email": {
      "type": "string",
      "description": "Contact email address"
    },
    "phone": {
      "type": "string",
      "description": "Contact phone number"
    },
    "mobile": {
      "type": "string",
      "description": "Contact mobile number"
    },
    "job_title": {
      "type": "string",
      "description": "Contact job title"
    },
    "company_id": {
      "type": "string",
      "description": "Associated company ID"
    },
    "address": {
      "type": "string",
      "description": "Contact address"
    },
    "description": {
      "type": "string",
      "description": "Contact description"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags for the contact"
    },
    "custom_fields": {
      "type": "object",
      "additionalProperties": true,
      "description": "Custom field values"
    }
  },
  "required": [
    "PCID",
    "name",
    "email"
  ]
}

freshdesk_get_contact

Retrieve a contact by ID Parameters:

Parameter	Type	Required	Default	Description
`contact_id`	string	Yes	—	Contact ID to retrieve

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID to retrieve"
    }
  },
  "required": [
    "PCID",
    "contact_id"
  ]
}

freshdesk_update_contact

Update an existing contact Parameters:

Parameter	Type	Required	Default	Description
`contact_id`	string	Yes	—	Contact ID to update
`name`	string	No	—	Updated name
`email`	string	No	—	Updated email
`phone`	string	No	—	Updated phone
`mobile`	string	No	—	Updated mobile
`job_title`	string	No	—	Updated job title
`address`	string	No	—	Updated address
`description`	string	No	—	Updated description
`tags`	string[]	No	—	Updated tags
`custom_fields`	object	No	—	Updated custom field values

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "contact_id": {
      "type": "string",
      "description": "Contact ID to update"
    },
    "name": {
      "type": "string",
      "description": "Updated name"
    },
    "email": {
      "type": "string",
      "description": "Updated email"
    },
    "phone": {
      "type": "string",
      "description": "Updated phone"
    },
    "mobile": {
      "type": "string",
      "description": "Updated mobile"
    },
    "job_title": {
      "type": "string",
      "description": "Updated job title"
    },
    "address": {
      "type": "string",
      "description": "Updated address"
    },
    "description": {
      "type": "string",
      "description": "Updated description"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Updated tags"
    },
    "custom_fields": {
      "type": "object",
      "additionalProperties": true,
      "description": "Updated custom field values"
    }
  },
  "required": [
    "PCID",
    "contact_id"
  ]
}

freshdesk_create_company

Create a new company in Freshdesk Parameters:

Parameter	Type	Required	Default	Description
`name`	string	Yes	—	Company name
`description`	string	No	—	Company description
`note`	string	No	—	Company note
`domains`	string[]	No	—	Company email domains
`custom_fields`	object	No	—	Custom field values

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "name": {
      "type": "string",
      "description": "Company name"
    },
    "description": {
      "type": "string",
      "description": "Company description"
    },
    "note": {
      "type": "string",
      "description": "Company note"
    },
    "domains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Company email domains"
    },
    "custom_fields": {
      "type": "object",
      "additionalProperties": true,
      "description": "Custom field values"
    }
  },
  "required": [
    "PCID",
    "name"
  ]
}

freshdesk_get_company

Retrieve a company by ID Parameters:

Parameter	Type	Required	Default	Description
`company_id`	string	Yes	—	Company ID to retrieve

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "company_id": {
      "type": "string",
      "description": "Company ID to retrieve"
    }
  },
  "required": [
    "PCID",
    "company_id"
  ]
}

freshdesk_search_tickets

Search tickets using Freshdesk query language Parameters:

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Search query using Freshdesk query language (e.g., “priority:3 AND status:2”)
`page`	number	No	`1`	Page number for pagination

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "query": {
      "type": "string",
      "description": "Search query using Freshdesk query language (e.g., \"priority:3 AND status:2\")"
    },
    "page": {
      "type": "number",
      "default": 1,
      "description": "Page number for pagination"
    }
  },
  "required": [
    "PCID",
    "query"
  ]
}

freshdesk_get_agents

Get list of agents in Freshdesk Parameters:

Parameter	Type	Required	Default	Description
`state`	string	No	—	Filter agents by state
`page`	number	No	`1`	Page number for pagination

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "state": {
      "type": "string",
      "enum": [
        "fulltime",
        "occasional"
      ],
      "description": "Filter agents by state"
    },
    "page": {
      "type": "number",
      "default": 1,
      "description": "Page number for pagination"
    }
  },
  "required": [
    "PCID"
  ]
}

freshdesk_get_groups

Get list of agent groups

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    }
  },
  "required": [
    "PCID"
  ]
}

freshdesk_get_time_entries

Get time entries for tickets Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	string	No	—	Filter by specific ticket ID
`agent_id`	string	No	—	Filter by specific agent ID
`company_id`	string	No	—	Filter by company ID
`executed_before`	string	No	—	Filter entries before this date (YYYY-MM-DD)
`executed_after`	string	No	—	Filter entries after this date (YYYY-MM-DD)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "ticket_id": {
      "type": "string",
      "description": "Filter by specific ticket ID"
    },
    "agent_id": {
      "type": "string",
      "description": "Filter by specific agent ID"
    },
    "company_id": {
      "type": "string",
      "description": "Filter by company ID"
    },
    "executed_before": {
      "type": "string",
      "description": "Filter entries before this date (YYYY-MM-DD)"
    },
    "executed_after": {
      "type": "string",
      "description": "Filter entries after this date (YYYY-MM-DD)"
    }
  },
  "required": [
    "PCID"
  ]
}

freshdesk_create_time_entry

Create a time entry for a ticket Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	string	Yes	—	Ticket ID
`time_spent`	string	Yes	—	Time spent (e.g., “01:30” for 1 hour 30 minutes)
`note`	string	No	—	Note about the time entry
`agent_id`	string	No	—	Agent ID (defaults to current user)
`billable`	boolean	No	`true`	Whether the time is billable

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "ticket_id": {
      "type": "string",
      "description": "Ticket ID"
    },
    "time_spent": {
      "type": "string",
      "description": "Time spent (e.g., \"01:30\" for 1 hour 30 minutes)"
    },
    "note": {
      "type": "string",
      "description": "Note about the time entry"
    },
    "agent_id": {
      "type": "string",
      "description": "Agent ID (defaults to current user)"
    },
    "billable": {
      "type": "boolean",
      "default": true,
      "description": "Whether the time is billable"
    }
  },
  "required": [
    "PCID",
    "ticket_id",
    "time_spent"
  ]
}

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

Tools

freshdesk_create_ticket

freshdesk_get_ticket

freshdesk_update_ticket

freshdesk_list_tickets

freshdesk_add_note

freshdesk_create_contact

freshdesk_get_contact

freshdesk_update_contact

freshdesk_create_company

freshdesk_get_company

freshdesk_search_tickets

freshdesk_get_agents

freshdesk_get_groups

freshdesk_get_time_entries

freshdesk_create_time_entry

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

​Tools

​freshdesk_create_ticket

​freshdesk_get_ticket

​freshdesk_update_ticket

​freshdesk_list_tickets

​freshdesk_add_note

​freshdesk_create_contact

​freshdesk_get_contact

​freshdesk_update_contact

​freshdesk_create_company

​freshdesk_get_company

​freshdesk_search_tickets

​freshdesk_get_agents

​freshdesk_get_groups

​freshdesk_get_time_entries

​freshdesk_create_time_entry

Tools

freshdesk_create_ticket

freshdesk_get_ticket

freshdesk_update_ticket

freshdesk_list_tickets

freshdesk_add_note

freshdesk_create_contact

freshdesk_get_contact

freshdesk_update_contact

freshdesk_create_company

freshdesk_get_company

freshdesk_search_tickets

freshdesk_get_agents

freshdesk_get_groups

freshdesk_get_time_entries

freshdesk_create_time_entry