Documentation Index Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
Use this file to discover all available pages before exploring further.
Server path: /freshdesk-companies | Type: Application | PCID required: Yes
freshdesk_companies_create_company
Create a company
Parameters:
Parameter Type Required Default Description account_tierstring No — Account tier custom_fieldsobject No — Custom field key-value pairs descriptionstring No — The description value domainsstring[] No — Email domains to associate health_scorestring No — Health score industrystring No — The industry value namestring Yes — Name of the company notestring No — Notes renewal_datestring No — Renewal date
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"account_tier" : {
"type" : "string" ,
"description" : "Account tier"
},
"custom_fields" : {
"type" : "object" ,
"description" : "Custom field key-value pairs"
},
"description" : {
"type" : "string" ,
"description" : "The description value"
},
"domains" : {
"type" : "array" ,
"items" : {
"type" : "string"
},
"description" : "Email domains to associate"
},
"health_score" : {
"type" : "string" ,
"description" : "Health score"
},
"industry" : {
"type" : "string" ,
"description" : "The industry value"
},
"name" : {
"type" : "string" ,
"description" : "Name of the company"
},
"note" : {
"type" : "string" ,
"description" : "Notes"
},
"renewal_date" : {
"type" : "string" ,
"description" : "Renewal date"
}
},
"required" : [
"PCID" ,
"name"
]
}
freshdesk_companies_create_custom_object_record
Create a custom object record
Parameters:
Parameter Type Required Default Description schema_idstring Yes — ID of the custom object schema dataobject Yes — Key-value pairs of field values for the record
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"schema_id" : {
"type" : "string" ,
"description" : "ID of the custom object schema"
},
"data" : {
"type" : "object" ,
"description" : "Key-value pairs of field values for the record"
}
},
"required" : [
"PCID" ,
"schema_id" ,
"data"
]
}
freshdesk_companies_delete_company
Delete a company
Parameters:
Parameter Type Required Default Description idinteger Yes — ID of the company to delete
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"id" : {
"type" : "integer" ,
"description" : "ID of the company to delete"
}
},
"required" : [
"PCID" ,
"id"
]
}
freshdesk_companies_delete_custom_object_record
Delete a custom object record
Parameters:
Parameter Type Required Default Description schema_idstring Yes — ID of the custom object schema record_idstring Yes — ID of the custom object record
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"schema_id" : {
"type" : "string" ,
"description" : "ID of the custom object schema"
},
"record_id" : {
"type" : "string" ,
"description" : "ID of the custom object record"
}
},
"required" : [
"PCID" ,
"schema_id" ,
"record_id"
]
}
freshdesk_companies_export_companies
Export companies
Parameters:
Parameter Type Required Default Description custom_fieldsobject No — Custom company fields to include in the export default_fieldsobject No — Default company fields to include in the export
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"custom_fields" : {
"type" : "object" ,
"description" : "Custom company fields to include in the export"
},
"default_fields" : {
"type" : "object" ,
"description" : "Default company fields to include in the export"
}
},
"required" : [
"PCID"
]
}
freshdesk_companies_get_company
Get a company
Parameters:
Parameter Type Required Default Description idinteger Yes — ID of the company
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"id" : {
"type" : "integer" ,
"description" : "ID of the company"
}
},
"required" : [
"PCID" ,
"id"
]
}
freshdesk_companies_get_custom_object_record
Get a custom object record
Parameters:
Parameter Type Required Default Description schema_idstring Yes — ID of the custom object schema record_idstring Yes — ID of the custom object record
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"schema_id" : {
"type" : "string" ,
"description" : "ID of the custom object schema"
},
"record_id" : {
"type" : "string" ,
"description" : "ID of the custom object record"
}
},
"required" : [
"PCID" ,
"schema_id" ,
"record_id"
]
}
freshdesk_companies_get_custom_object_schema
Get a custom object schema
Parameters:
Parameter Type Required Default Description schema_idstring Yes — ID of the custom object schema
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"schema_id" : {
"type" : "string" ,
"description" : "ID of the custom object schema"
}
},
"required" : [
"PCID" ,
"schema_id"
]
}
freshdesk_companies_list_companies
List all companies
Parameters:
Parameter Type Required Default Description pageinteger No — Page number for pagination per_pageinteger No — Number of results per page (max 100)
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"page" : {
"type" : "integer" ,
"description" : "Page number for pagination"
},
"per_page" : {
"type" : "integer" ,
"description" : "Number of results per page (max 100)"
}
},
"required" : [
"PCID"
]
}
freshdesk_companies_list_company_fields
List all company fields
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
}
},
"required" : [
"PCID"
]
}
freshdesk_companies_list_custom_object_records
List custom object records
Parameters:
Parameter Type Required Default Description schema_idstring Yes — ID of the custom object schema pageinteger No — Page number for pagination (starts at 1) per_pageinteger No — Number of results per page (max 100)
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"schema_id" : {
"type" : "string" ,
"description" : "ID of the custom object schema"
},
"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" ,
"schema_id"
]
}
freshdesk_companies_list_custom_object_schemas
List custom object schemas
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
}
},
"required" : [
"PCID"
]
}
freshdesk_companies_search_companies
Search companies
Parameters:
Parameter Type Required Default Description querystring 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. pageinteger No — Page number for pagination
{
"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"
}
},
"required" : [
"PCID" ,
"query"
]
}
freshdesk_companies_update_company
Update a company
Parameters:
Parameter Type Required Default Description idinteger Yes — ID of the company to update account_tierstring No — Account tier custom_fieldsobject No — Custom field key-value pairs descriptionstring No — The description value domainsstring[] No — Email domains health_scorestring No — Health score industrystring No — The industry value namestring No — Name of the company notestring No — Notes renewal_datestring No — Renewal date
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"id" : {
"type" : "integer" ,
"description" : "ID of the company to update"
},
"account_tier" : {
"type" : "string" ,
"description" : "Account tier"
},
"custom_fields" : {
"type" : "object" ,
"description" : "Custom field key-value pairs"
},
"description" : {
"type" : "string" ,
"description" : "The description value"
},
"domains" : {
"type" : "array" ,
"items" : {
"type" : "string"
},
"description" : "Email domains"
},
"health_score" : {
"type" : "string" ,
"description" : "Health score"
},
"industry" : {
"type" : "string" ,
"description" : "The industry value"
},
"name" : {
"type" : "string" ,
"description" : "Name of the company"
},
"note" : {
"type" : "string" ,
"description" : "Notes"
},
"renewal_date" : {
"type" : "string" ,
"description" : "Renewal date"
}
},
"required" : [
"PCID" ,
"id"
]
}
freshdesk_companies_update_custom_object_record
Update a custom object record
Parameters:
Parameter Type Required Default Description schema_idstring Yes — ID of the custom object schema record_idstring Yes — ID of the custom object record dataobject No — Key-value pairs of field values to update
{
"type" : "object" ,
"properties" : {
"PCID" : {
"type" : "string" ,
"description" : "Pink Connect ID for the authenticated connection"
},
"schema_id" : {
"type" : "string" ,
"description" : "ID of the custom object schema"
},
"record_id" : {
"type" : "string" ,
"description" : "ID of the custom object record"
},
"data" : {
"type" : "object" ,
"description" : "Key-value pairs of field values to update"
}
},
"required" : [
"PCID" ,
"schema_id" ,
"record_id"
]
}