Skip to main content
Server path: /freshsales-utilities | Type: Application | PCID required: Yes

Tools

ToolDescription
freshsales_utilities_clone_custom_module_recordClone a custom module record
freshsales_utilities_create_custom_fieldCreate a custom field on a module
freshsales_utilities_create_custom_moduleCreate a custom module definition
freshsales_utilities_create_custom_module_recordCreate a record in a custom module
freshsales_utilities_delete_custom_moduleDelete a custom module definition
freshsales_utilities_delete_custom_module_recordDelete a custom module record
freshsales_utilities_forget_custom_module_recordPermanently delete (forget) a custom module record
freshsales_utilities_get_custom_module_recordGet a custom module record by ID
freshsales_utilities_get_job_statusGet the status of an async job
freshsales_utilities_list_business_typesList business types
freshsales_utilities_list_campaignsList campaigns
freshsales_utilities_list_contact_statusesList contact statuses
freshsales_utilities_list_currenciesList configured currencies
freshsales_utilities_list_custom_module_records_by_viewList custom module records in a view
freshsales_utilities_list_custom_modulesList all custom module definitions
freshsales_utilities_list_deal_payment_statusesList deal payment statuses
freshsales_utilities_list_deal_reasonsList deal (won/lost) reasons
freshsales_utilities_list_deal_stagesList deal stages
freshsales_utilities_list_deal_stages_by_pipelineList deal stages for a pipeline
freshsales_utilities_list_deal_typesList deal types
freshsales_utilities_list_designationsList designations
freshsales_utilities_list_industry_typesList industry types
freshsales_utilities_list_lead_sourcesList lead sources
freshsales_utilities_list_lifecycle_stagesList lifecycle stages
freshsales_utilities_list_module_fieldsList field definitions for a module
freshsales_utilities_list_ownersList available owners
freshsales_utilities_list_sales_activity_outcomesList sales activity outcomes
freshsales_utilities_list_sales_activity_typesList sales activity types
freshsales_utilities_list_territoriesList territories
freshsales_utilities_lookupLook up records by a specific field value
freshsales_utilities_searchFull-text search across CRM entities
freshsales_utilities_update_custom_moduleUpdate a custom module definition
freshsales_utilities_update_custom_module_recordUpdate a custom module record

freshsales_utilities_clone_custom_module_record

Clone a custom module record Parameters:
ParameterTypeRequiredDefaultDescription
entityNamestringYesThe API name of the custom module.
idintegerYesNumeric ID of the record to clone.

freshsales_utilities_create_custom_field

Create a custom field on a module Parameters:
ParameterTypeRequiredDefaultDescription
entityTypestringYesThe entity type to add the field to (e.g., ‘contacts’, ‘sales_accounts’, ‘deals’, or a custom module API name).
formIdintegerYesNumeric ID of the form to add the field to. Use listModuleFields to discover form IDs.
fieldobjectYesField definition. Common keys: name (required), label (required), type (required — e.g., ‘text’, ‘number’, ‘dropdown’, ‘date’, ‘checkbox’), required (boolean), choices (array, for dropdown fields).

freshsales_utilities_create_custom_module

Create a custom module definition Parameters:
ParameterTypeRequiredDefaultDescription
module_customizationobjectYesModule definition fields. Common keys: name (required), label, label_in_plural, icon_name, description.

freshsales_utilities_create_custom_module_record

Create a record in a custom module Parameters:
ParameterTypeRequiredDefaultDescription
entityNamestringYesThe API name of the custom module (e.g., ‘cm_vehicles’). Use listCustomModules to discover available names.
custom_moduleobjectYesRecord fields. Keys depend on the custom module’s field definitions (e.g., cf_make, cf_model, cf_year). Use listModuleFields to discover available fields.

freshsales_utilities_delete_custom_module

Delete a custom module definition Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesNumeric ID of the custom module definition to delete.

freshsales_utilities_delete_custom_module_record

Delete a custom module record Parameters:
ParameterTypeRequiredDefaultDescription
entityNamestringYesThe API name of the custom module.
idintegerYesNumeric ID of the record to delete.

freshsales_utilities_forget_custom_module_record

Permanently delete (forget) a custom module record Parameters:
ParameterTypeRequiredDefaultDescription
entityNamestringYesThe API name of the custom module.
idintegerYesNumeric ID of the record to permanently delete.

freshsales_utilities_get_custom_module_record

Get a custom module record by ID Parameters:
ParameterTypeRequiredDefaultDescription
entityNamestringYesThe API name of the custom module.
idintegerYesNumeric ID of the record.
includestringNoComma-separated list of associated resources to side-load.

freshsales_utilities_get_job_status

Get the status of an async job Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesNumeric ID of the job (as returned by a prior bulk operation).

freshsales_utilities_list_business_types

List business types

freshsales_utilities_list_campaigns

List campaigns

freshsales_utilities_list_contact_statuses

List contact statuses

freshsales_utilities_list_currencies

List configured currencies

freshsales_utilities_list_custom_module_records_by_view

List custom module records in a view Parameters:
ParameterTypeRequiredDefaultDescription
entityNamestringYesThe API name of the custom module.
viewIdintegerYesThe numeric ID of the saved view/filter.
pageintegerNoPage number for paginated results (default 1).
sortstringNoField name to sort the result set by.
sort_typestringNoSort direction.

freshsales_utilities_list_custom_modules

List all custom module definitions

freshsales_utilities_list_deal_payment_statuses

List deal payment statuses

freshsales_utilities_list_deal_reasons

List deal (won/lost) reasons

freshsales_utilities_list_deal_stages

List deal stages

freshsales_utilities_list_deal_stages_by_pipeline

List deal stages for a pipeline Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesNumeric ID of the deal pipeline.

freshsales_utilities_list_deal_types

List deal types

freshsales_utilities_list_designations

List designations

freshsales_utilities_list_industry_types

List industry types

freshsales_utilities_list_lead_sources

List lead sources

freshsales_utilities_list_lifecycle_stages

List lifecycle stages

freshsales_utilities_list_module_fields

List field definitions for a module Parameters:
ParameterTypeRequiredDefaultDescription
entityTypestringYesThe entity type (e.g., ‘contacts’, ‘sales_accounts’, ‘deals’, or a custom module API name).

freshsales_utilities_list_owners

List available owners

freshsales_utilities_list_sales_activity_outcomes

List sales activity outcomes

freshsales_utilities_list_sales_activity_types

List sales activity types

freshsales_utilities_list_territories

List territories

freshsales_utilities_lookup

Look up records by a specific field value Parameters:
ParameterTypeRequiredDefaultDescription
qstringYesThe value to match against the field.
fstringYesThe name of the field to match on (e.g., “email”, “website”).
entitiesstringYesComma-separated list of entity types to search across. Valid values: contact, sales_account, deal.

Full-text search across CRM entities Parameters:
ParameterTypeRequiredDefaultDescription
qstringYesThe search query string.
includestringYesComma-separated list of entity types to search across. Valid values: contact, sales_account, deal, user, lead.

freshsales_utilities_update_custom_module

Update a custom module definition Parameters:
ParameterTypeRequiredDefaultDescription
idintegerYesNumeric ID of the custom module definition.
module_customizationobjectYesPartial module definition fields to update.

freshsales_utilities_update_custom_module_record

Update a custom module record Parameters:
ParameterTypeRequiredDefaultDescription
entityNamestringYesThe API name of the custom module.
idintegerYesNumeric ID of the record to update.
custom_moduleobjectYesPartial record fields to update.