/freshdesk-tickets | Type: Application | PCID required: Yes
Tools
freshdesk_tickets_add_note_to_ticket
Add a note to a ticket Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket to add a note to |
body | string | Yes | — | HTML content of the note |
notify_emails | string[] | No | — | Array of agent email addresses to notify about this note |
private | boolean | No | — | Whether the note is private (only visible to agents). Default: true |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket to add a note to"
},
"body": {
"type": "string",
"description": "HTML content of the note"
},
"notify_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of agent email addresses to notify about this note"
},
"private": {
"type": "boolean",
"description": "Whether the note is private (only visible to agents). Default: true"
}
},
"required": [
"PCID",
"id",
"body"
]
}
freshdesk_tickets_create_ticket
Create a ticket Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cc_emails | string[] | No | — | Email addresses to CC |
company_id | integer | No | — | ID of the company to associate |
custom_fields | object | No | — | Key-value pairs for custom fields |
description | string | Yes | — | HTML content of the ticket description |
due_by | string | No | — | Due date for the ticket |
email | string | No | — | Email address of the requester. Required if requester_id is not provided. |
facebook_id | string | No | — | Facebook ID of the requester |
fr_due_by | string | No | — | First response due date |
group_id | integer | No | — | ID of the group to assign the ticket to |
phone | string | No | — | Phone number of the requester |
priority | integer | No | — | Priority: 1=Low, 2=Medium, 3=High, 4=Urgent |
product_id | integer | No | — | ID of the product to associate |
requester_id | integer | No | — | ID of the requester contact. Required if email is not provided. |
responder_id | integer | No | — | ID of the agent to assign the ticket to |
source | integer | No | — | Source: 1=Email, 2=Portal, 3=Phone, 7=Chat, 9=Feedback Widget, 10=Outbound Email |
status | integer | No | — | Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed |
subject | string | Yes | — | Subject of the ticket |
tags | string[] | No | — | Tags to associate with the ticket |
twitter_id | string | No | — | Twitter handle of the requester |
type | string | No | — | Ticket type (e.g., Question, Incident, Problem, Feature Request) |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"cc_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Email addresses to CC"
},
"company_id": {
"type": "integer",
"description": "ID of the company to associate"
},
"custom_fields": {
"type": "object",
"description": "Key-value pairs for custom fields"
},
"description": {
"type": "string",
"description": "HTML content of the ticket description"
},
"due_by": {
"type": "string",
"description": "Due date for the ticket"
},
"email": {
"type": "string",
"description": "Email address of the requester. Required if requester_id is not provided."
},
"facebook_id": {
"type": "string",
"description": "Facebook ID of the requester"
},
"fr_due_by": {
"type": "string",
"description": "First response due date"
},
"group_id": {
"type": "integer",
"description": "ID of the group to assign the ticket to"
},
"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
]
},
"product_id": {
"type": "integer",
"description": "ID of the product to associate"
},
"requester_id": {
"type": "integer",
"description": "ID of the requester contact. Required if email is not provided."
},
"responder_id": {
"type": "integer",
"description": "ID of the agent to assign the ticket to"
},
"source": {
"type": "integer",
"description": "Source: 1=Email, 2=Portal, 3=Phone, 7=Chat, 9=Feedback Widget, 10=Outbound Email",
"enum": [
1,
2,
3,
7,
9,
10
]
},
"status": {
"type": "integer",
"description": "Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed",
"enum": [
2,
3,
4,
5
]
},
"subject": {
"type": "string",
"description": "Subject of the ticket"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to associate with the ticket"
},
"twitter_id": {
"type": "string",
"description": "Twitter handle of the requester"
},
"type": {
"type": "string",
"description": "Ticket type (e.g., Question, Incident, Problem, Feature Request)"
}
},
"required": [
"PCID",
"description",
"subject"
]
}
freshdesk_tickets_create_ticket_form
Create a ticket form Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
fields | object[] | No | — | Fields to include in the form |
name | string | Yes | — | Name of the ticket form |
title | string | No | — | Display title of the ticket form |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"fields": {
"type": "array",
"items": {
"type": "object"
},
"description": "Fields to include in the form"
},
"name": {
"type": "string",
"description": "Name of the ticket form"
},
"title": {
"type": "string",
"description": "Display title of the ticket form"
}
},
"required": [
"PCID",
"name"
]
}
freshdesk_tickets_delete_conversation
Delete a conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the conversation to delete |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the conversation to delete"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_delete_ticket
Delete a ticket Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket to delete |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket to delete"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_delete_ticket_form
Delete a ticket form Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket form to delete |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket form to delete"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_forward_ticket
Forward a ticket Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket to forward |
bcc_emails | string[] | No | — | List of BCC email addresses |
body | string | Yes | — | HTML body of the forwarded message |
cc_emails | string[] | No | — | List of CC email addresses |
to_emails | string[] | Yes | — | List of recipient email addresses |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket to forward"
},
"bcc_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of BCC email addresses"
},
"body": {
"type": "string",
"description": "HTML body of the forwarded message"
},
"cc_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of CC email addresses"
},
"to_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of recipient email addresses"
}
},
"required": [
"PCID",
"id",
"body",
"to_emails"
]
}
freshdesk_tickets_get_ticket
Get a ticket Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket |
include | string | No | — | Include additional information. Comma-separated: conversations, requester, company, stats, sla_policy |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket"
},
"include": {
"type": "string",
"description": "Include additional information. Comma-separated: conversations, requester, company, stats, sla_policy"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_get_ticket_form
Get a ticket form Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket form |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket form"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_get_ticket_summary
Get ticket summary Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_list_ticket_conversations
List conversations for a ticket Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket |
page | integer | No | — | Page number for pagination |
per_page | integer | No | — | Number of results per page (max 100) |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket"
},
"page": {
"type": "integer",
"description": "Page number for pagination"
},
"per_page": {
"type": "integer",
"description": "Number of results per page (max 100)"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_list_ticket_fields
List all ticket fieldsShow inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
}
},
"required": [
"PCID"
]
}
freshdesk_tickets_list_ticket_forms
List all ticket formsShow inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
}
},
"required": [
"PCID"
]
}
freshdesk_tickets_list_ticket_watchers
List ticket watchers Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_list_tickets
List all tickets Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filter | string | No | — | Pre-defined filter to use. One of: new_and_my_open, watching, spam, deleted |
requester_id | integer | No | — | Filter tickets by requester ID |
email | string | No | — | Filter tickets by requester email |
company_id | integer | No | — | Filter tickets by company ID |
updated_since | string | No | — | Return tickets updated since this date-time (ISO 8601 format) |
order_by | string | No | — | Field to order results by. One of: created_at, due_by, updated_at, status |
order_type | string | No | — | Sort order: asc or desc |
include | string | No | — | Include additional information. Comma-separated: requester, stats, company, description |
page | integer | No | — | Page number for pagination (starts at 1) |
per_page | integer | No | — | Number of results per page (max 100) |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"filter": {
"type": "string",
"description": "Pre-defined filter to use. One of: 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"
},
"company_id": {
"type": "integer",
"description": "Filter tickets by company ID"
},
"updated_since": {
"type": "string",
"description": "Return tickets updated since this date-time (ISO 8601 format)"
},
"order_by": {
"type": "string",
"description": "Field to order results by. One of: created_at, due_by, updated_at, status"
},
"order_type": {
"type": "string",
"description": "Sort order: asc or desc",
"enum": [
"asc",
"desc"
]
},
"include": {
"type": "string",
"description": "Include additional information. Comma-separated: requester, stats, company, description"
},
"page": {
"type": "integer",
"description": "Page number for pagination (starts at 1)"
},
"per_page": {
"type": "integer",
"description": "Number of results per page (max 100)"
}
},
"required": [
"PCID"
]
}
freshdesk_tickets_merge_tickets
Merge tickets Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
primary_id | integer | Yes | — | ID of the primary ticket to merge into |
ticket_ids | integer[] | Yes | — | IDs of secondary tickets to merge |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"primary_id": {
"type": "integer",
"description": "ID of the primary ticket to merge into"
},
"ticket_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "IDs of secondary tickets to merge"
}
},
"required": [
"PCID",
"primary_id",
"ticket_ids"
]
}
freshdesk_tickets_reply_to_ticket
Reply to a ticket Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket to reply to |
bcc_emails | string[] | No | — | Array of email addresses to BCC |
body | string | Yes | — | HTML content of the reply |
cc_emails | string[] | No | — | Array of email addresses to CC |
from_email | string | No | — | Email address from which the reply is sent. By default the global support email is used. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket to reply to"
},
"bcc_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of email addresses to BCC"
},
"body": {
"type": "string",
"description": "HTML content of the reply"
},
"cc_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of email addresses to CC"
},
"from_email": {
"type": "string",
"description": "Email address from which the reply is sent. By default the global support email is used."
}
},
"required": [
"PCID",
"id",
"body"
]
}
freshdesk_tickets_restore_ticket
Restore a deleted ticket Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket to restore |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket to restore"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_search_tickets
Search tickets Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Search query using Freshdesk query language. The value MUST be enclosed in double quotes, e.g. “status:2 AND priority:3”. Without the surrounding quotes, the API will return an error. |
page | integer | No | — | Page number for pagination (starts at 1, max 10 pages) |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"query": {
"type": "string",
"description": "Search query using Freshdesk query language. The value MUST be enclosed in double quotes, e.g. \"status:2 AND priority:3\". Without the surrounding quotes, the API will return an error."
},
"page": {
"type": "integer",
"description": "Page number for pagination (starts at 1, max 10 pages)"
}
},
"required": [
"PCID",
"query"
]
}
freshdesk_tickets_update_conversation
Update a conversation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the conversation to update |
attachments | string[] | No | — | Updated attachments for the conversation |
body | string | No | — | Updated HTML content of the conversation |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the conversation to update"
},
"attachments": {
"type": "array",
"items": {
"type": "string"
},
"description": "Updated attachments for the conversation"
},
"body": {
"type": "string",
"description": "Updated HTML content of the conversation"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_update_ticket
Update a ticket Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket to update |
cc_emails | string[] | No | — | CC email addresses |
company_id | integer | No | — | Company ID |
custom_fields | object | No | — | Custom field key-value pairs |
description | string | No | — | HTML content of the ticket description |
due_by | string | No | — | Due date |
email | string | No | — | Requester email |
fr_due_by | string | No | — | First response due date |
group_id | integer | No | — | ID of the group to assign |
phone | string | No | — | Requester phone |
priority | integer | No | — | Priority: 1=Low, 2=Medium, 3=High, 4=Urgent |
product_id | integer | No | — | Product ID |
responder_id | integer | No | — | ID of the agent to assign |
source | integer | No | — | Source: 1=Email, 2=Portal, 3=Phone, 7=Chat, 9=Feedback Widget, 10=Outbound Email |
status | integer | No | — | Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed |
subject | string | No | — | Subject of the ticket |
tags | string[] | No | — | Tags for the ticket |
type | string | No | — | Ticket type |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket to update"
},
"cc_emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "CC email addresses"
},
"company_id": {
"type": "integer",
"description": "Company ID"
},
"custom_fields": {
"type": "object",
"description": "Custom field key-value pairs"
},
"description": {
"type": "string",
"description": "HTML content of the ticket description"
},
"due_by": {
"type": "string",
"description": "Due date"
},
"email": {
"type": "string",
"description": "Requester email"
},
"fr_due_by": {
"type": "string",
"description": "First response due date"
},
"group_id": {
"type": "integer",
"description": "ID of the group to assign"
},
"phone": {
"type": "string",
"description": "Requester phone"
},
"priority": {
"type": "integer",
"description": "Priority: 1=Low, 2=Medium, 3=High, 4=Urgent",
"enum": [
1,
2,
3,
4
]
},
"product_id": {
"type": "integer",
"description": "Product ID"
},
"responder_id": {
"type": "integer",
"description": "ID of the agent to assign"
},
"source": {
"type": "integer",
"description": "Source: 1=Email, 2=Portal, 3=Phone, 7=Chat, 9=Feedback Widget, 10=Outbound Email",
"enum": [
1,
2,
3,
7,
9,
10
]
},
"status": {
"type": "integer",
"description": "Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed",
"enum": [
2,
3,
4,
5
]
},
"subject": {
"type": "string",
"description": "Subject of the ticket"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for the ticket"
},
"type": {
"type": "string",
"description": "Ticket type"
}
},
"required": [
"PCID",
"id"
]
}
freshdesk_tickets_update_ticket_form
Update a ticket form Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the ticket form to update |
fields | object[] | No | — | Fields to include |
name | string | No | — | Name of the ticket form |
title | string | No | — | Display title |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"id": {
"type": "integer",
"description": "ID of the ticket form to update"
},
"fields": {
"type": "array",
"items": {
"type": "object"
},
"description": "Fields to include"
},
"name": {
"type": "string",
"description": "Name of the ticket form"
},
"title": {
"type": "string",
"description": "Display title"
}
},
"required": [
"PCID",
"id"
]
}