freshservice

Server path: /freshservice | Type: Application | PCID required: Yes

Tools

Tool	Description
`freshservice_add_ticket_note`	Add a note to a ticket
`freshservice_create_agent`	Create an agent
`freshservice_create_asset`	Create an asset
`freshservice_create_change`	Create a change request
`freshservice_create_department`	Create a department
`freshservice_create_problem`	Create a problem
`freshservice_create_requester`	Create a requester
`freshservice_create_ticket`	Create a new ticket
`freshservice_delete_ticket`	Delete a ticket
`freshservice_get_asset`	Get an asset
`freshservice_get_ticket`	Get a ticket
`freshservice_list_agent_groups`	List all agent groups
`freshservice_list_agents`	List all agents
`freshservice_list_assets`	List all assets
`freshservice_list_changes`	List all changes
`freshservice_list_departments`	List all departments
`freshservice_list_locations`	List all locations
`freshservice_list_problems`	List all problems
`freshservice_list_requesters`	List all requesters
`freshservice_list_service_catalog_items`	List service catalog items
`freshservice_list_ticket_conversations`	List conversations of a ticket
`freshservice_list_tickets`	List all tickets
`freshservice_reply_to_ticket`	Reply to a ticket
`freshservice_search_assets`	DEPRECATED — Search assets by query. Use list_assets with the query parameter instead.
`freshservice_update_asset`	Update an asset
`freshservice_update_ticket`	Update a ticket

freshservice_add_ticket_note

Add a note to a ticket Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	integer	Yes	—	ID of the ticket
`body`	string	Yes	—	HTML content of the note
`notify_emails`	string[]	No	—	Email addresses to notify
`private`	boolean	No	—	Whether the note is private (default: true)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ticket_id": {
      "type": "integer",
      "description": "ID of the ticket"
    },
    "body": {
      "type": "string",
      "description": "HTML content of the note"
    },
    "notify_emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses to notify"
    },
    "private": {
      "type": "boolean",
      "description": "Whether the note is private (default: true)"
    }
  },
  "required": [
    "PCID",
    "ticket_id",
    "body"
  ]
}

freshservice_create_agent

Create an agent Parameters:

Parameter	Type	Required	Default	Description
`department_ids`	integer[]	No	—	Department IDs
`email`	string	Yes	—	Email address (must be unique)
`first_name`	string	No	—	First name
`group_ids`	integer[]	No	—	Group IDs
`job_title`	string	No	—	Job title
`last_name`	string	No	—	Last name
`location_id`	integer	No	—	Location ID
`mobile_phone_number`	string	No	—	Mobile phone number
`occasional`	boolean	No	—	Whether the agent is occasional (true) or full-time (false)
`phone`	string	No	—	Phone number
`role_ids`	integer[]	No	—	Role IDs

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "department_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Department IDs"
    },
    "email": {
      "type": "string",
      "description": "Email address (must be unique)"
    },
    "first_name": {
      "type": "string",
      "description": "First name"
    },
    "group_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Group IDs"
    },
    "job_title": {
      "type": "string",
      "description": "Job title"
    },
    "last_name": {
      "type": "string",
      "description": "Last name"
    },
    "location_id": {
      "type": "integer",
      "description": "Location ID"
    },
    "mobile_phone_number": {
      "type": "string",
      "description": "Mobile phone number"
    },
    "occasional": {
      "type": "boolean",
      "description": "Whether the agent is occasional (true) or full-time (false)"
    },
    "phone": {
      "type": "string",
      "description": "Phone number"
    },
    "role_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Role IDs"
    }
  },
  "required": [
    "PCID",
    "email"
  ]
}

freshservice_create_asset

Create an asset Parameters:

Parameter	Type	Required	Default	Description
`agent_id`	integer	No	—	ID of the agent managing the asset
`asset_tag`	string	No	—	Asset tag identifier
`asset_type_id`	integer	Yes	—	ID of the asset type
`assigned_on`	string	No	—	Date when asset was assigned
`department_id`	integer	No	—	ID of the department
`description`	string	No	—	Description of the asset
`group_id`	integer	No	—	ID of the agent group
`impact`	string	No	—	Impact level (low, medium, high)
`location_id`	integer	No	—	ID of the location
`name`	string	Yes	—	Name of the asset
`usage_type`	string	No	—	Usage type (permanent, loaner)
`user_id`	integer	No	—	ID of the user associated with the asset

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "agent_id": {
      "type": "integer",
      "description": "ID of the agent managing the asset"
    },
    "asset_tag": {
      "type": "string",
      "description": "Asset tag identifier"
    },
    "asset_type_id": {
      "type": "integer",
      "description": "ID of the asset type"
    },
    "assigned_on": {
      "type": "string",
      "description": "Date when asset was assigned"
    },
    "department_id": {
      "type": "integer",
      "description": "ID of the department"
    },
    "description": {
      "type": "string",
      "description": "Description of the asset"
    },
    "group_id": {
      "type": "integer",
      "description": "ID of the agent group"
    },
    "impact": {
      "type": "string",
      "description": "Impact level (low, medium, high)",
      "enum": [
        "low",
        "medium",
        "high"
      ]
    },
    "location_id": {
      "type": "integer",
      "description": "ID of the location"
    },
    "name": {
      "type": "string",
      "description": "Name of the asset"
    },
    "usage_type": {
      "type": "string",
      "description": "Usage type (permanent, loaner)"
    },
    "user_id": {
      "type": "integer",
      "description": "ID of the user associated with the asset"
    }
  },
  "required": [
    "PCID",
    "asset_type_id",
    "name"
  ]
}

freshservice_create_change

Create a change request Parameters:

Parameter	Type	Required	Default	Description
`agent_id`	integer	No	—	ID of the agent
`category`	string	No	—	The category value
`change_type`	integer	Yes	—	Type: 1=Minor, 2=Standard, 3=Major, 4=Emergency
`description`	string	No	—	Description in HTML
`impact`	integer	Yes	—	Impact: 1=Low, 2=Medium, 3=High
`planned_end_date`	string	Yes	—	Planned end date
`planned_start_date`	string	Yes	—	Planned start date
`priority`	integer	Yes	—	Priority: 1=Low, 2=Medium, 3=High, 4=Urgent
`requester_id`	integer	Yes	—	ID of the requester
`risk`	integer	Yes	—	Risk: 1=Low, 2=Medium, 3=High, 4=Very High
`status`	integer	No	—	Status: 1=Open, 2=Planning, 3=Awaiting Approval, 4=Pending Release, 5=Pending Review, 6=Closed
`sub_category`	string	No	—	Sub-category
`subject`	string	Yes	—	Subject of the change

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "agent_id": {
      "type": "integer",
      "description": "ID of the agent"
    },
    "category": {
      "type": "string",
      "description": "The category value"
    },
    "change_type": {
      "type": "integer",
      "description": "Type: 1=Minor, 2=Standard, 3=Major, 4=Emergency",
      "enum": [
        1,
        2,
        3,
        4
      ]
    },
    "description": {
      "type": "string",
      "description": "Description in HTML"
    },
    "impact": {
      "type": "integer",
      "description": "Impact: 1=Low, 2=Medium, 3=High",
      "enum": [
        1,
        2,
        3
      ]
    },
    "planned_end_date": {
      "type": "string",
      "description": "Planned end date"
    },
    "planned_start_date": {
      "type": "string",
      "description": "Planned start date"
    },
    "priority": {
      "type": "integer",
      "description": "Priority: 1=Low, 2=Medium, 3=High, 4=Urgent",
      "enum": [
        1,
        2,
        3,
        4
      ]
    },
    "requester_id": {
      "type": "integer",
      "description": "ID of the requester"
    },
    "risk": {
      "type": "integer",
      "description": "Risk: 1=Low, 2=Medium, 3=High, 4=Very High",
      "enum": [
        1,
        2,
        3,
        4
      ]
    },
    "status": {
      "type": "integer",
      "description": "Status: 1=Open, 2=Planning, 3=Awaiting Approval, 4=Pending Release, 5=Pending Review, 6=Closed"
    },
    "sub_category": {
      "type": "string",
      "description": "Sub-category"
    },
    "subject": {
      "type": "string",
      "description": "Subject of the change"
    }
  },
  "required": [
    "PCID",
    "change_type",
    "impact",
    "planned_end_date",
    "planned_start_date",
    "priority",
    "requester_id",
    "risk",
    "subject"
  ]
}

freshservice_create_department

Create a department Parameters:

Parameter	Type	Required	Default	Description
`description`	string	No	—	The description value
`domains`	string[]	No	—	Email domains associated with the department
`head_user_id`	integer	No	—	ID of the department head
`name`	string	Yes	—	Name of the department
`prime_user_id`	integer	No	—	ID of the primary contact

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "domains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email domains associated with the department"
    },
    "head_user_id": {
      "type": "integer",
      "description": "ID of the department head"
    },
    "name": {
      "type": "string",
      "description": "Name of the department"
    },
    "prime_user_id": {
      "type": "integer",
      "description": "ID of the primary contact"
    }
  },
  "required": [
    "PCID",
    "name"
  ]
}

freshservice_create_problem

Create a problem Parameters:

Parameter	Type	Required	Default	Description
`agent_id`	integer	No	—	ID of the agent
`category`	string	No	—	The category value
`description`	string	No	—	Description in HTML
`due_by`	string	No	—	Due date
`group_id`	integer	No	—	Group ID
`impact`	integer	Yes	—	Impact: 1=Low, 2=Medium, 3=High
`item_category`	string	No	—	Item category
`known_error`	boolean	No	—	Whether this is a known error
`priority`	integer	Yes	—	Priority: 1=Low, 2=Medium, 3=High, 4=Urgent
`requester_id`	integer	Yes	—	ID of the requester
`status`	integer	Yes	—	Status: 1=Open, 2=Change Requested, 3=Closed
`sub_category`	string	No	—	Sub-category
`subject`	string	Yes	—	Subject of the problem

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "agent_id": {
      "type": "integer",
      "description": "ID of the agent"
    },
    "category": {
      "type": "string",
      "description": "The category value"
    },
    "description": {
      "type": "string",
      "description": "Description in HTML"
    },
    "due_by": {
      "type": "string",
      "description": "Due date"
    },
    "group_id": {
      "type": "integer",
      "description": "Group ID"
    },
    "impact": {
      "type": "integer",
      "description": "Impact: 1=Low, 2=Medium, 3=High",
      "enum": [
        1,
        2,
        3
      ]
    },
    "item_category": {
      "type": "string",
      "description": "Item category"
    },
    "known_error": {
      "type": "boolean",
      "description": "Whether this is a known error"
    },
    "priority": {
      "type": "integer",
      "description": "Priority: 1=Low, 2=Medium, 3=High, 4=Urgent",
      "enum": [
        1,
        2,
        3,
        4
      ]
    },
    "requester_id": {
      "type": "integer",
      "description": "ID of the requester"
    },
    "status": {
      "type": "integer",
      "description": "Status: 1=Open, 2=Change Requested, 3=Closed",
      "enum": [
        1,
        2,
        3
      ]
    },
    "sub_category": {
      "type": "string",
      "description": "Sub-category"
    },
    "subject": {
      "type": "string",
      "description": "Subject of the problem"
    }
  },
  "required": [
    "PCID",
    "impact",
    "priority",
    "requester_id",
    "status",
    "subject"
  ]
}

freshservice_create_requester

Create a requester Parameters:

Parameter	Type	Required	Default	Description
`department_ids`	integer[]	No	—	Department IDs
`email`	string	No	—	Primary email of the requester
`first_name`	string	Yes	—	First name of the requester
`job_title`	string	No	—	Job title
`language`	string	No	—	Language preference
`last_name`	string	No	—	Last name of the requester
`location_id`	integer	No	—	Location ID
`mobile_phone_number`	string	No	—	Mobile phone number
`phone`	string	No	—	Phone number
`time_zone`	string	No	—	Time zone

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "department_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Department IDs"
    },
    "email": {
      "type": "string",
      "description": "Primary email of the requester"
    },
    "first_name": {
      "type": "string",
      "description": "First name of the requester"
    },
    "job_title": {
      "type": "string",
      "description": "Job title"
    },
    "language": {
      "type": "string",
      "description": "Language preference"
    },
    "last_name": {
      "type": "string",
      "description": "Last name of the requester"
    },
    "location_id": {
      "type": "integer",
      "description": "Location ID"
    },
    "mobile_phone_number": {
      "type": "string",
      "description": "Mobile phone number"
    },
    "phone": {
      "type": "string",
      "description": "Phone number"
    },
    "time_zone": {
      "type": "string",
      "description": "Time zone"
    }
  },
  "required": [
    "PCID",
    "first_name"
  ]
}

freshservice_create_ticket

Create a new ticket Parameters:

Parameter	Type	Required	Default	Description
`category`	string	No	—	Category of the ticket
`description`	string	Yes	—	HTML content of the ticket
`due_by`	string	No	—	Ticket due date
`email`	string	No	—	Email of the requester. If no contact exists with this email, a new one is created.
`fr_due_by`	string	No	—	First response due date
`group_id`	integer	No	—	ID of the group to which the ticket is assigned
`impact`	integer	No	—	Impact: 1=Low, 2=Medium, 3=High
`item_category`	string	No	—	Item category of the ticket
`phone`	string	No	—	Phone number of the requester
`priority`	integer	Yes	—	Priority: 1=Low, 2=Medium, 3=High, 4=Urgent
`requester_id`	integer	No	—	ID of the requester. Must be an existing contact.
`responder_id`	integer	No	—	ID of the agent to whom the ticket is assigned
`source`	integer	No	—	Source: 1=Email, 2=Portal, 3=Phone, 4=Chat, 5=Feedback Widget, 6=Yammer, 7=AWS Cloudwatch, 8=Pagerduty, 9=Walkup, 10=Slack
`status`	integer	Yes	—	Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed
`sub_category`	string	No	—	Sub-category of the ticket
`subject`	string	Yes	—	Ticket subject
`tags`	string[]	No	—	Tags for the ticket
`type`	string	No	—	Ticket type (e.g., ‘Incident’, ‘Service Request’)
`urgency`	integer	No	—	Urgency: 1=Low, 2=Medium, 3=High
`workspace_id`	integer	No	—	Workspace ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "category": {
      "type": "string",
      "description": "Category of the ticket"
    },
    "description": {
      "type": "string",
      "description": "HTML content of the ticket"
    },
    "due_by": {
      "type": "string",
      "description": "Ticket due date"
    },
    "email": {
      "type": "string",
      "description": "Email of the requester. If no contact exists with this email, a new one is created."
    },
    "fr_due_by": {
      "type": "string",
      "description": "First response due date"
    },
    "group_id": {
      "type": "integer",
      "description": "ID of the group to which the ticket is assigned"
    },
    "impact": {
      "type": "integer",
      "description": "Impact: 1=Low, 2=Medium, 3=High",
      "enum": [
        1,
        2,
        3
      ]
    },
    "item_category": {
      "type": "string",
      "description": "Item category of the ticket"
    },
    "phone": {
      "type": "string",
      "description": "Phone number of the requester"
    },
    "priority": {
      "type": "integer",
      "description": "Priority: 1=Low, 2=Medium, 3=High, 4=Urgent",
      "enum": [
        1,
        2,
        3,
        4
      ]
    },
    "requester_id": {
      "type": "integer",
      "description": "ID of the requester. Must be an existing contact."
    },
    "responder_id": {
      "type": "integer",
      "description": "ID of the agent to whom the ticket is assigned"
    },
    "source": {
      "type": "integer",
      "description": "Source: 1=Email, 2=Portal, 3=Phone, 4=Chat, 5=Feedback Widget, 6=Yammer, 7=AWS Cloudwatch, 8=Pagerduty, 9=Walkup, 10=Slack",
      "enum": [
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10
      ]
    },
    "status": {
      "type": "integer",
      "description": "Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed",
      "enum": [
        2,
        3,
        4,
        5
      ]
    },
    "sub_category": {
      "type": "string",
      "description": "Sub-category of the ticket"
    },
    "subject": {
      "type": "string",
      "description": "Ticket subject"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags for the ticket"
    },
    "type": {
      "type": "string",
      "description": "Ticket type (e.g., 'Incident', 'Service Request')"
    },
    "urgency": {
      "type": "integer",
      "description": "Urgency: 1=Low, 2=Medium, 3=High",
      "enum": [
        1,
        2,
        3
      ]
    },
    "workspace_id": {
      "type": "integer",
      "description": "Workspace ID"
    }
  },
  "required": [
    "PCID",
    "description",
    "priority",
    "status",
    "subject"
  ]
}

freshservice_delete_ticket

Delete a ticket Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	integer	Yes	—	ID of the ticket

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ticket_id": {
      "type": "integer",
      "description": "ID of the ticket"
    }
  },
  "required": [
    "PCID",
    "ticket_id"
  ]
}

freshservice_get_asset

Get an asset Parameters:

Parameter	Type	Required	Default	Description
`asset_display_id`	integer	Yes	—	Display ID of the asset

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Display ID of the asset"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

freshservice_get_ticket

Get a ticket Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	integer	Yes	—	ID of the ticket
`include`	string	No	—	Include additional information (e.g., ‘requester’, ‘stats’, ‘conversations’, ‘tags’)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ticket_id": {
      "type": "integer",
      "description": "ID of the ticket"
    },
    "include": {
      "type": "string",
      "description": "Include additional information (e.g., 'requester', 'stats', 'conversations', 'tags')"
    }
  },
  "required": [
    "PCID",
    "ticket_id"
  ]
}

freshservice_list_agent_groups

List all agent groups Parameters:

Parameter	Type	Required	Default	Description
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Records per page (max 100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Records per page (max 100)"
    }
  },
  "required": [
    "PCID"
  ]
}

freshservice_list_agents

List all agents Parameters:

Parameter	Type	Required	Default	Description
`email`	string	No	—	Filter by email
`active`	boolean	No	—	Filter by active status
`state`	string	No	—	Filter by state (fulltime, occasional)
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Records per page (max 100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "email": {
      "type": "string",
      "description": "Filter by email"
    },
    "active": {
      "type": "boolean",
      "description": "Filter by active status"
    },
    "state": {
      "type": "string",
      "description": "Filter by state (fulltime, occasional)",
      "enum": [
        "fulltime",
        "occasional"
      ]
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Records per page (max 100)"
    }
  },
  "required": [
    "PCID"
  ]
}

freshservice_list_assets

List all assets Parameters:

Parameter	Type	Required	Default	Description
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Records per page (max 100)
`include`	string	No	—	Include additional info (e.g., ‘type_fields’)
`query`	string	No	—	Search query to filter assets (e.g., “name:‘Dell Laptop’“)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Records per page (max 100)"
    },
    "include": {
      "type": "string",
      "description": "Include additional info (e.g., 'type_fields')"
    },
    "query": {
      "type": "string",
      "description": "Search query to filter assets (e.g., \"name:'Dell Laptop'\")"
    }
  },
  "required": [
    "PCID"
  ]
}

freshservice_list_changes

List all changes Parameters:

Parameter	Type	Required	Default	Description
`filter`	string	No	—	Predefined filter
`updated_since`	string	No	—	Filter changes updated since date
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Records per page (max 100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "filter": {
      "type": "string",
      "description": "Predefined filter"
    },
    "updated_since": {
      "type": "string",
      "description": "Filter changes updated since date"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Records per page (max 100)"
    }
  },
  "required": [
    "PCID"
  ]
}

freshservice_list_departments

List all departments Parameters:

Parameter	Type	Required	Default	Description
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Records per page (max 100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Records per page (max 100)"
    }
  },
  "required": [
    "PCID"
  ]
}

freshservice_list_locations

List all locations Parameters:

Parameter	Type	Required	Default	Description
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Records per page (max 100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Records per page (max 100)"
    }
  },
  "required": [
    "PCID"
  ]
}

freshservice_list_problems

List all problems Parameters:

Parameter	Type	Required	Default	Description
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Records per page (max 100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Records per page (max 100)"
    }
  },
  "required": [
    "PCID"
  ]
}

freshservice_list_requesters

List all requesters Parameters:

Parameter	Type	Required	Default	Description
`email`	string	No	—	Filter by email address
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Records per page (max 100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "email": {
      "type": "string",
      "description": "Filter by email address"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Records per page (max 100)"
    }
  },
  "required": [
    "PCID"
  ]
}

freshservice_list_service_catalog_items

List service catalog items Parameters:

Parameter	Type	Required	Default	Description
`category_id`	integer	No	—	Filter by category ID
`page`	integer	No	—	Page number
`per_page`	integer	No	—	Records per page (max 100)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "category_id": {
      "type": "integer",
      "description": "Filter by category ID"
    },
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Records per page (max 100)"
    }
  },
  "required": [
    "PCID"
  ]
}

freshservice_list_ticket_conversations

List conversations of a ticket Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	integer	Yes	—	ID of the ticket

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ticket_id": {
      "type": "integer",
      "description": "ID of the ticket"
    }
  },
  "required": [
    "PCID",
    "ticket_id"
  ]
}

freshservice_list_tickets

List all tickets Parameters:

Parameter	Type	Required	Default	Description
`filter`	string	No	—	Filter criteria for tickets (e.g., ‘new_and_my_open’, ‘watching’, ‘spam’, ‘deleted’)
`requester_id`	integer	No	—	Filter tickets by requester ID
`email`	string	No	—	Filter tickets by requester email
`updated_since`	string	No	—	Filter tickets updated since this date (ISO 8601 format)
`type`	string	No	—	Filter by ticket type (e.g., ‘Incident’, ‘Service Request’)
`order_by`	string	No	—	Sort field (e.g., ‘created_at’, ‘due_by’, ‘updated_at’)
`order_type`	string	No	—	Sort direction: ‘asc’ or ‘desc’
`page`	integer	No	—	Page number for pagination
`per_page`	integer	No	—	Number of records per page (max 100)
`include`	string	No	—	Include additional information (e.g., ‘requester’, ‘stats’, ‘tags’)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "filter": {
      "type": "string",
      "description": "Filter criteria for tickets (e.g., 'new_and_my_open', 'watching', 'spam', 'deleted')"
    },
    "requester_id": {
      "type": "integer",
      "description": "Filter tickets by requester ID"
    },
    "email": {
      "type": "string",
      "description": "Filter tickets by requester email"
    },
    "updated_since": {
      "type": "string",
      "description": "Filter tickets updated since this date (ISO 8601 format)"
    },
    "type": {
      "type": "string",
      "description": "Filter by ticket type (e.g., 'Incident', 'Service Request')"
    },
    "order_by": {
      "type": "string",
      "description": "Sort field (e.g., 'created_at', 'due_by', 'updated_at')"
    },
    "order_type": {
      "type": "string",
      "description": "Sort direction: 'asc' or 'desc'",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "type": "integer",
      "description": "Page number for pagination"
    },
    "per_page": {
      "type": "integer",
      "description": "Number of records per page (max 100)"
    },
    "include": {
      "type": "string",
      "description": "Include additional information (e.g., 'requester', 'stats', 'tags')"
    }
  },
  "required": [
    "PCID"
  ]
}

freshservice_reply_to_ticket

Reply to a ticket Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	integer	Yes	—	ID of the ticket
`bcc_emails`	string[]	No	—	BCC email addresses
`body`	string	Yes	—	HTML content of the reply
`cc_emails`	string[]	No	—	CC email addresses
`from_email`	string	No	—	Email address from which the reply is sent

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ticket_id": {
      "type": "integer",
      "description": "ID of the ticket"
    },
    "bcc_emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "BCC email addresses"
    },
    "body": {
      "type": "string",
      "description": "HTML content of the reply"
    },
    "cc_emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "CC email addresses"
    },
    "from_email": {
      "type": "string",
      "description": "Email address from which the reply is sent"
    }
  },
  "required": [
    "PCID",
    "ticket_id",
    "body"
  ]
}

freshservice_search_assets

DEPRECATED — Search assets by query. Use list_assets with the query parameter instead. Parameters:

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Search query to filter assets (e.g., “name:‘Dell Laptop’“)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "query": {
      "type": "string",
      "description": "Search query to filter assets (e.g., \"name:'Dell Laptop'\")"
    }
  },
  "required": [
    "PCID",
    "query"
  ]
}

freshservice_update_asset

Update an asset Parameters:

Parameter	Type	Required	Default	Description
`asset_display_id`	integer	Yes	—	Display ID of the asset
`agent_id`	integer	No	—	Agent ID
`asset_tag`	string	No	—	Asset tag
`asset_type_id`	integer	No	—	Asset type ID
`department_id`	integer	No	—	Department ID
`description`	string	No	—	The description value
`group_id`	integer	No	—	Group ID
`impact`	string	No	—	Impact level
`location_id`	integer	No	—	Location ID
`name`	string	No	—	Name of the asset
`usage_type`	string	No	—	Usage type
`user_id`	integer	No	—	User ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "asset_display_id": {
      "type": "integer",
      "description": "Display ID of the asset"
    },
    "agent_id": {
      "type": "integer",
      "description": "Agent ID"
    },
    "asset_tag": {
      "type": "string",
      "description": "Asset tag"
    },
    "asset_type_id": {
      "type": "integer",
      "description": "Asset type ID"
    },
    "department_id": {
      "type": "integer",
      "description": "Department ID"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "group_id": {
      "type": "integer",
      "description": "Group ID"
    },
    "impact": {
      "type": "string",
      "description": "Impact level",
      "enum": [
        "low",
        "medium",
        "high"
      ]
    },
    "location_id": {
      "type": "integer",
      "description": "Location ID"
    },
    "name": {
      "type": "string",
      "description": "Name of the asset"
    },
    "usage_type": {
      "type": "string",
      "description": "Usage type"
    },
    "user_id": {
      "type": "integer",
      "description": "User ID"
    }
  },
  "required": [
    "PCID",
    "asset_display_id"
  ]
}

freshservice_update_ticket

Update a ticket Parameters:

Parameter	Type	Required	Default	Description
`ticket_id`	integer	Yes	—	ID of the ticket
`category`	string	No	—	Ticket category
`description`	string	No	—	HTML content of the ticket
`due_by`	string	No	—	Due date
`fr_due_by`	string	No	—	First response due date
`group_id`	integer	No	—	Group ID
`impact`	integer	No	—	Impact level
`item_category`	string	No	—	Item category
`priority`	integer	No	—	Priority: 1=Low, 2=Medium, 3=High, 4=Urgent
`responder_id`	integer	No	—	Agent ID
`source`	integer	No	—	Source channel
`status`	integer	No	—	Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed
`sub_category`	string	No	—	Sub-category
`subject`	string	No	—	Ticket subject
`tags`	string[]	No	—	The tags value
`type`	string	No	—	Ticket type
`urgency`	integer	No	—	Urgency level

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "ticket_id": {
      "type": "integer",
      "description": "ID of the ticket"
    },
    "category": {
      "type": "string",
      "description": "Ticket category"
    },
    "description": {
      "type": "string",
      "description": "HTML content of the ticket"
    },
    "due_by": {
      "type": "string",
      "description": "Due date"
    },
    "fr_due_by": {
      "type": "string",
      "description": "First response due date"
    },
    "group_id": {
      "type": "integer",
      "description": "Group ID"
    },
    "impact": {
      "type": "integer",
      "description": "Impact level"
    },
    "item_category": {
      "type": "string",
      "description": "Item category"
    },
    "priority": {
      "type": "integer",
      "description": "Priority: 1=Low, 2=Medium, 3=High, 4=Urgent",
      "enum": [
        1,
        2,
        3,
        4
      ]
    },
    "responder_id": {
      "type": "integer",
      "description": "Agent ID"
    },
    "source": {
      "type": "integer",
      "description": "Source channel"
    },
    "status": {
      "type": "integer",
      "description": "Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed",
      "enum": [
        2,
        3,
        4,
        5
      ]
    },
    "sub_category": {
      "type": "string",
      "description": "Sub-category"
    },
    "subject": {
      "type": "string",
      "description": "Ticket subject"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The tags value"
    },
    "type": {
      "type": "string",
      "description": "Ticket type"
    },
    "urgency": {
      "type": "integer",
      "description": "Urgency level"
    }
  },
  "required": [
    "PCID",
    "ticket_id"
  ]
}

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

Skills Guides

Tools

freshservice_add_ticket_note

freshservice_create_agent

freshservice_create_asset

freshservice_create_change

freshservice_create_department

freshservice_create_problem

freshservice_create_requester

freshservice_create_ticket

freshservice_delete_ticket

freshservice_get_asset

freshservice_get_ticket

freshservice_list_agent_groups

freshservice_list_agents

freshservice_list_assets

freshservice_list_changes

freshservice_list_departments

freshservice_list_locations

freshservice_list_problems

freshservice_list_requesters

freshservice_list_service_catalog_items

freshservice_list_ticket_conversations

freshservice_list_tickets

freshservice_reply_to_ticket

freshservice_search_assets

freshservice_update_asset

freshservice_update_ticket

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

Skills Guides

Documentation Index

​Tools

​freshservice_add_ticket_note

​freshservice_create_agent

​freshservice_create_asset

​freshservice_create_change

​freshservice_create_department

​freshservice_create_problem

​freshservice_create_requester

​freshservice_create_ticket

​freshservice_delete_ticket

​freshservice_get_asset

​freshservice_get_ticket

​freshservice_list_agent_groups

​freshservice_list_agents

​freshservice_list_assets

​freshservice_list_changes

​freshservice_list_departments

​freshservice_list_locations

​freshservice_list_problems

​freshservice_list_requesters

​freshservice_list_service_catalog_items

​freshservice_list_ticket_conversations

​freshservice_list_tickets

​freshservice_reply_to_ticket

​freshservice_search_assets

​freshservice_update_asset

​freshservice_update_ticket

Tools

freshservice_add_ticket_note

freshservice_create_agent

freshservice_create_asset

freshservice_create_change

freshservice_create_department

freshservice_create_problem

freshservice_create_requester

freshservice_create_ticket

freshservice_delete_ticket

freshservice_get_asset

freshservice_get_ticket

freshservice_list_agent_groups

freshservice_list_agents

freshservice_list_assets

freshservice_list_changes

freshservice_list_departments

freshservice_list_locations

freshservice_list_problems

freshservice_list_requesters

freshservice_list_service_catalog_items

freshservice_list_ticket_conversations

freshservice_list_tickets

freshservice_reply_to_ticket

freshservice_search_assets

freshservice_update_asset

freshservice_update_ticket