/freshsales-utilities | Type: Application | PCID required: Yes
Tools
freshsales_utilities_clone_custom_module_record
Clone a custom module record Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entityName | string | Yes | — | The API name of the custom module. |
id | integer | Yes | — | Numeric ID of the record to clone. |
freshsales_utilities_create_custom_field
Create a custom field on a module Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entityType | string | Yes | — | The entity type to add the field to (e.g., ‘contacts’, ‘sales_accounts’, ‘deals’, or a custom module API name). |
formId | integer | Yes | — | Numeric ID of the form to add the field to. Use listModuleFields to discover form IDs. |
field | object | Yes | — | Field 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
module_customization | object | Yes | — | Module 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entityName | string | Yes | — | The API name of the custom module (e.g., ‘cm_vehicles’). Use listCustomModules to discover available names. |
custom_module | object | Yes | — | Record 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the custom module definition to delete. |
freshsales_utilities_delete_custom_module_record
Delete a custom module record Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entityName | string | Yes | — | The API name of the custom module. |
id | integer | Yes | — | Numeric ID of the record to delete. |
freshsales_utilities_forget_custom_module_record
Permanently delete (forget) a custom module record Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entityName | string | Yes | — | The API name of the custom module. |
id | integer | Yes | — | Numeric ID of the record to permanently delete. |
freshsales_utilities_get_custom_module_record
Get a custom module record by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entityName | string | Yes | — | The API name of the custom module. |
id | integer | Yes | — | Numeric ID of the record. |
include | string | No | — | Comma-separated list of associated resources to side-load. |
freshsales_utilities_get_job_status
Get the status of an async job Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the job (as returned by a prior bulk operation). |
freshsales_utilities_list_business_types
List business typesfreshsales_utilities_list_campaigns
List campaignsfreshsales_utilities_list_contact_statuses
List contact statusesfreshsales_utilities_list_currencies
List configured currenciesfreshsales_utilities_list_custom_module_records_by_view
List custom module records in a view Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entityName | string | Yes | — | The API name of the custom module. |
viewId | integer | Yes | — | The numeric ID of the saved view/filter. |
page | integer | No | — | Page number for paginated results (default 1). |
sort | string | No | — | Field name to sort the result set by. |
sort_type | string | No | — | Sort direction. |
freshsales_utilities_list_custom_modules
List all custom module definitionsfreshsales_utilities_list_deal_payment_statuses
List deal payment statusesfreshsales_utilities_list_deal_reasons
List deal (won/lost) reasonsfreshsales_utilities_list_deal_stages
List deal stagesfreshsales_utilities_list_deal_stages_by_pipeline
List deal stages for a pipeline Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the deal pipeline. |
freshsales_utilities_list_deal_types
List deal typesfreshsales_utilities_list_designations
List designationsfreshsales_utilities_list_industry_types
List industry typesfreshsales_utilities_list_lead_sources
List lead sourcesfreshsales_utilities_list_lifecycle_stages
List lifecycle stagesfreshsales_utilities_list_module_fields
List field definitions for a module Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entityType | string | Yes | — | The entity type (e.g., ‘contacts’, ‘sales_accounts’, ‘deals’, or a custom module API name). |
freshsales_utilities_list_owners
List available ownersfreshsales_utilities_list_sales_activity_outcomes
List sales activity outcomesfreshsales_utilities_list_sales_activity_types
List sales activity typesfreshsales_utilities_list_territories
List territoriesfreshsales_utilities_lookup
Look up records by a specific field value Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | Yes | — | The value to match against the field. |
f | string | Yes | — | The name of the field to match on (e.g., “email”, “website”). |
entities | string | Yes | — | Comma-separated list of entity types to search across. Valid values: contact, sales_account, deal. |
freshsales_utilities_search
Full-text search across CRM entities Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | Yes | — | The search query string. |
include | string | Yes | — | Comma-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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the custom module definition. |
module_customization | object | Yes | — | Partial module definition fields to update. |
freshsales_utilities_update_custom_module_record
Update a custom module record Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entityName | string | Yes | — | The API name of the custom module. |
id | integer | Yes | — | Numeric ID of the record to update. |
custom_module | object | Yes | — | Partial record fields to update. |

