Freshsales

Node catalog Actions

On this page

Manage CRM contacts, leads, companies and opportunities.

Usage and specifics

Choose the CRM credential, account URL, object and action. Reading, updating and deleting require the record ID. Guided fields override matching advanced JSON keys. Responses retain provider envelopes and pagination; renew OAuth tokens in credentials.

Technical type : freshsales. Runtime : nodulz.

Credentials and prerequisites

Freshsales (integration / freshsales). Freshsales API key from Profile > API settings.

Create credentials in your nodulz instance’s Credentials area, then select them on the node. Availability depends on ownership and sharing. See the credentials guide for access and rotation.

Parameters

Names below are technical keys. Defaults are not a ready-to-run configuration: complete fields required by your operation. Paths containing [] describe list items; some fields depend on the selected mode.

Parameter	Type	Default	Values / limits
`credentialId`	`string`	`""`	-
`operation`	`enum`	`"list"`	`list`, `get`, `create`, `update`, `delete`
`host`	`string`	`""`	-
`resource`	`string`	`"contacts"`	-
`resourceId`	`string`	`""`	-
`viewId`	`string`	`""`	-
`fields`	`array`	`[]`	-
`fields[].name`	`string`	-	-
`fields[].value`	`string`	-	-
`data`	`string`	`"{}"`	-
`query`	`string`	`"{}"`	-

Configuration help

host CRM account URL: HTTPS origin only, without a path or parameters. See the example below. Official provider domains are supported.
resource CRM object: Exact API object or table name. Salesforce, Zoho and Dynamics also accept custom names. Changing the object resets fields and parameters.
viewId View ID: Required for Freshsales lists. Find views with GET /crm/sales/api/contacts/filters, replacing contacts with the selected resource. Enter the numeric view ID.

Initial configuration

Initial catalog configuration example, to adapt before running. Keep secrets in credentials.

json

{
  "credentialId": "",
  "operation": "list",
  "host": "",
  "resource": "contacts",
  "resourceId": "",
  "viewId": "",
  "fields": [],
  "data": "{}",
  "query": "{}"
}

Verification

Test with representative data. Check node output in the inspector and logs, then use editor mapping for downstream fields. A trigger test with a simulated payload does not validate external service delivery.