Reference · Tools

Salesmate

Manage companies, activities, and deals in Salesmate CRM

Action Sales v1

The Salesmate node manages companies, activities and deals in the Salesmate CRM with full CRUD and search. A typical build is creating a deal from a qualified lead and logging every follow-up as an activity against it.

Node type
Action
Parameters
59
Outputs
Output, Error
Credentials
Salesmate API

Salesmate

Manage companies, activities, and deals in Salesmate CRM

Overview

Salesmate is a CRM platform for managing sales pipelines. This tool supports CRUD operations on companies, activities (calls, meetings, tasks), and deals, including searching with complex filter conditions.

Category: Sales
Tool Name: salesmate
Version: 1

Appearance: Icon: lucide-CircleDollarSign | Color: #5D70AE

Node Type

Action — processes input items and produces output

Input / Output

DirectionPort(s)
InputInput
OutputOutput, Error

Credentials

This tool requires Salesmate API credentials. See the Credentials Guide for setup instructions.

Resources

ResourceValue
Activityactivity
Companycompany
Dealdeal

Operations

All three resources offer the same five operations. Pick the resource first, then the operation.

OperationValue
Createcreate
Deletedelete
Getget
Get ManygetAll
Updateupdate

Parameters

Owner, contact and company identifiers are Salesmate record IDs. All text fields accept expressions such as {{ $json.companyId }}, so you can feed them from an upstream item.

Company: Create

ParameterTypeRequiredDefaultDescription
NamestringYesThe name of the company.
OwnerstringYesOwner user ID. Find in Salesmate: Settings > Users.
RAW DatabooleanNofalseWhether the data should include the fields details.
Additional Fields (additionalFields)collectionNo{}Optional company fields to set on creation.
— WebsitestringNo
— PhonestringNo
— Other PhonestringNo
— Facebook HandlestringNo
— Google Plus HandlestringNo
— LinkedIn HandlestringNo
— Skype IDstringNo
— Twitter HandlestringNo
— CurrencystringNo
— Billing Address Line 1stringNo
— Billing Address Line 2stringNo
— Billing CitystringNo
— Billing Zip CodestringNo
— Billing StatestringNo
— DescriptionstringNo
— TagsstringNo

Company: Update

ParameterTypeRequiredDefaultDescription
Company ID (id)stringYesThe ID of the company to update.
RAW DatabooleanNofalseWhether the data should include the fields details.
Update Fields (updateFields)collectionNo{}Company fields to change. Only the fields you add are sent.
— NamestringNo
— OwnerstringNoOwner user ID.
— WebsitestringNo
— PhonestringNo
— Other PhonestringNo
— Facebook HandlestringNo
— Google Plus HandlestringNo
— LinkedIn HandlestringNo
— Skype IDstringNo
— Twitter HandlestringNo
— CurrencystringNo
— Billing Address Line 1stringNo
— Billing Address Line 2stringNo
— Billing CitystringNo
— Billing Zip CodestringNo
— Billing StatestringNo
— DescriptionstringNo
— TagsstringNo

Company: Get

ParameterTypeRequiredDefaultDescription
Company ID (id)stringYesThe ID of the company to retrieve.
RAW DatabooleanNofalseWhether the data should include the fields details.

Company: Get Many

ParameterTypeRequiredDefaultDescription
Return AllbooleanNofalseWhether to return all results or only up to a given limit.
LimitnumberNo10Max number of results to return. Accepts 1–25. (shown when Return All is false)
JSON ParametersbooleanNofalseWhether to provide the search body as raw JSON.
Options (options)collectionNo{}Query options for the search request.
— FieldsstringNoComma-separated list of fields to return.
— Sort BystringNoThe field to sort by.
— Sort OrderoptionsNodesc
Options: asc, desc
Filters (JSON) (filtersJson)jsonNoJSON search body with fields, query, and group filter rules. (shown when JSON Parameters is true)
Filters (filters)fixedCollectionNo{}Structured filter conditions built in the editor. (shown when JSON Parameters is false)
— OperatoroptionsNoAND
Options: AND, OR
— ConditionsfixedCollectionNo{}The conditions this filter group evaluates.
— — FieldoptionsNoname
Options: name, email, phone
— — ConditionoptionsNoEQUALS
Options: EQUALS, NOT_EQUALS, Contains, DOES_NOT_CONTAINS, EMPTY, NOT_EMPTY, STARTS_WITH, ENDS_WITH
— — ValuestringNo

Company: Delete

ParameterTypeRequiredDefaultDescription
Company ID (id)stringYesID of the company to delete. If more than one, add them separated by comma.

Activity: Create

ParameterTypeRequiredDefaultDescription
TitlestringYesThe title of the activity.
OwnerstringYesOwner user ID. Find in Salesmate: Settings > Users.
TypestringYesActivity type such as “call”, “meeting”, “task”, etc.
RAW DatabooleanNofalseWhether the data should include the fields details.
Additional Fields (additionalFields)collectionNo{}Optional activity fields to set on creation.
— DescriptionstringNoDetails related to the activity.
— TagsstringNoTags associated with the activity.
— Due DatestringNoExpiry date of the activity (ISO 8601 format).
— DurationnumberNo0Time duration of the activity in minutes.
— Is Calendar InvitebooleanNofalseWhether to send a calendar invite.
— Is CompletedbooleanNofalseWhether the activity is completed.

Activity: Update

ParameterTypeRequiredDefaultDescription
Activity ID (id)stringYesThe ID of the activity to update.
RAW DatabooleanNofalseWhether the data should include the fields details.
Update Fields (updateFields)collectionNo{}Activity fields to change. Only the fields you add are sent.
— TitlestringNo
— TypestringNo
— OwnerstringNoOwner user ID.
— DescriptionstringNoDetails related to the activity.
— TagsstringNoTags associated with the activity.
— Due DatestringNoExpiry date (ISO 8601 format).
— DurationnumberNo0Time duration in minutes.
— Is Calendar InvitebooleanNofalseWhether to send a calendar invite.
— Is CompletedbooleanNofalseWhether the activity is completed.

Activity: Get

ParameterTypeRequiredDefaultDescription
Activity ID (id)stringYesThe ID of the activity to retrieve.
RAW DatabooleanNofalseWhether the data should include the fields details.

Activity: Get Many

ParameterTypeRequiredDefaultDescription
Return AllbooleanNofalseWhether to return all results or only up to a given limit.
LimitnumberNo10Max number of results to return. Accepts 1–25. (shown when Return All is false)
JSON ParametersbooleanNofalseWhether to provide the search body as raw JSON.
Options (options)collectionNo{}Query options for the search request.
— FieldsstringNoComma-separated list of fields to return.
— Sort BystringNoThe field to sort by.
— Sort OrderoptionsNodesc
Options: asc, desc
Filters (JSON) (filtersJson)jsonNoJSON search body with fields, query, and group filter rules. (shown when JSON Parameters is true)
Filters (filters)fixedCollectionNo{}Structured filter conditions built in the editor. (shown when JSON Parameters is false)
— OperatoroptionsNoAND
Options: AND, OR
— ConditionsfixedCollectionNo{}The conditions this filter group evaluates.
— — FieldoptionsNotitle
Options: title, tags
— — ConditionoptionsNoEQUALS
Options: EQUALS, NOT_EQUALS, Contains, DOES_NOT_CONTAINS, EMPTY, NOT_EMPTY, STARTS_WITH, ENDS_WITH
— — ValuestringNo

Activity: Delete

ParameterTypeRequiredDefaultDescription
Activity ID (id)stringYesID of the activity to delete. If more than one, add them separated by comma.

Deal: Create

ParameterTypeRequiredDefaultDescription
TitlestringYesThe title of the deal.
OwnerstringYesOwner user ID. Find in Salesmate: Settings > Users.
Primary ContactstringYesPrimary contact ID for the deal. Find in Salesmate contacts list.
PipelineoptionsYesSalesThe pipeline for the deal.
Options: Sales
StatusoptionsYesOpenThe status of the deal.
Options: Open, Close, Lost
StageoptionsYesThe stage of the deal.
Options: New (Untouched), Contacted, Qualified, In Negotiation, Proposal Presented
CurrencystringYesCurrency code (e.g. “USD”, “EUR”).
RAW DatabooleanNofalseWhether the data should include the fields details.
Additional Fields (additionalFields)collectionNo{}Optional deal fields to set on creation.
— DescriptionstringNoDetails related to the deal.
— TagsstringNoTags associated with the deal.
— Primary CompanystringNoPrimary company ID for the deal.
— SourceoptionsNoAds
Options: Ads, Referrals, Website, Word of mouth
— Estimated Close DatestringNoExpected close date (ISO 8601 format).
— Deal ValuenumberNo0Monetary value of the deal.
— PriorityoptionsNoMedium
Options: High, Medium, Low

Deal: Update

ParameterTypeRequiredDefaultDescription
Deal ID (id)stringYesThe ID of the deal to update.
RAW DatabooleanNofalseWhether the data should include the fields details.
Update Fields (updateFields)collectionNo{}Deal fields to change. Only the fields you add are sent.
— TitlestringNo
— OwnerstringNoOwner user ID.
— Primary ContactstringNoPrimary contact ID.
— PipelineoptionsNo
Options: Sales
— StatusoptionsNoOpen
Options: Open, Close, Lost
— StageoptionsNo
Options: Contacted, In Negotiation, New (Untouched), Proposal Presented, Qualified
— CurrencystringNo
— DescriptionstringNoDetails related to the deal.
— TagsstringNoTags associated with the deal.
— Primary CompanystringNoPrimary company ID.
— SourceoptionsNoAds
Options: Ads, Referrals, Website, Word of mouth
— Estimated Close DatestringNoExpected close date (ISO 8601).
— Deal ValuenumberNo0Monetary value of the deal.
— PriorityoptionsNoMedium
Options: High, Medium, Low

Deal: Get

ParameterTypeRequiredDefaultDescription
Deal ID (id)stringYesThe ID of the deal to retrieve.
RAW DatabooleanNofalseWhether the data should include the fields details.

Deal: Get Many

ParameterTypeRequiredDefaultDescription
Return AllbooleanNofalseWhether to return all results or only up to a given limit.
LimitnumberNo10Max number of results to return. Accepts 1–25. (shown when Return All is false)
JSON ParametersbooleanNofalseWhether to provide the search body as raw JSON.
Options (options)collectionNo{}Query options for the search request.
— FieldsstringNoComma-separated list of fields to return.
— Sort BystringNoThe field to sort by.
— Sort OrderoptionsNodesc
Options: asc, desc
Filters (JSON) (filtersJson)jsonNoJSON search body with fields, query, and group filter rules. (shown when JSON Parameters is true)
Filters (filters)fixedCollectionNo{}Structured filter conditions built in the editor. (shown when JSON Parameters is false)
— OperatoroptionsNoAND
Options: AND, OR
— ConditionsfixedCollectionNo{}The conditions this filter group evaluates.
— — FieldoptionsNotitle
Options: title, tags, lastCommunicationMode
— — ConditionoptionsNoEQUALS
Options: EQUALS, NOT_EQUALS, Contains, DOES_NOT_CONTAINS, EMPTY, NOT_EMPTY, STARTS_WITH, ENDS_WITH
— — ValuestringNo

Deal: Delete

ParameterTypeRequiredDefaultDescription
Deal ID (id)stringYesID of the deal to delete. If more than one, add them separated by comma.

All Operations

ParameterTypeRequiredDefaultDescription
Max ConcurrencynumberNo10Maximum number of items to process concurrently. Accepts 1–100.

Output Data

For every operation except Get Many, the Salesmate response is merged onto the input item’s JSON at the top level — the returned record’s fields sit alongside the fields the item already carried, so downstream nodes address them directly ({{ $json.id }}). A response field with the same name as an existing item field overwrites it. Binary data on the input item is forwarded unchanged, and one input item produces one output item.

Get Many replaces the item JSON instead of merging it. The search response fans out: each returned record becomes its own output item whose JSON is that record alone — nothing from the input item’s JSON carries over. Binary is still forwarded onto every item. A search that matches nothing produces no output items for that input.

OperationsOutput
Create, Update, Get on companies, activities and dealsOne output item; the returned record’s fields merged onto the input JSON.
Get Many on companies, activities and dealsOne output item per matching record, each carrying only that record’s fields.
Delete on companies, activities and dealsOne output item; the delete response merged onto the input JSON, or success: true when the API returns no body.

Leave RAW Data off to strip the verbose per-field detail block from Create, Update and Get responses; turn it on when you need Salesmate’s field metadata as well as the values.

Usage Examples

  • Create a new company in Salesmate
  • Search for all open deals
  • Update an activity status in Salesmate
  • Delete a company from Salesmate CRM

Example Configuration

Create a company with billing details:

{
  "type": "salesmate",
  "parameters": {
    "resource": "company",
    "operation": "create",
    "name": "Acme Corporation",
    "owner": "1",
    "rawData": true,
    "additionalFields": {
      "website": "https://acme.com",
      "phone": "+1-555-0123",
      "description": "Leading provider of innovative solutions",
      "currency": "USD",
      "billingAddressLine1": "123 Business St",
      "billingCity": "New York",
      "billingState": "NY",
      "billingZipCode": "10001"
    }
  }
}

Update a company using an ID carried on the incoming item:

{
  "type": "salesmate",
  "parameters": {
    "resource": "company",
    "operation": "update",
    "id": "{{ $json.companyId }}",
    "updateFields": {
      "name": "Acme Corporation Ltd",
      "website": "https://acme-corp.com",
      "phone": "+1-555-0124",
      "description": "Updated description"
    }
  }
}

Search companies with the structured filter builder, sorted by name:

{
  "type": "salesmate",
  "parameters": {
    "resource": "company",
    "operation": "getAll",
    "returnAll": false,
    "limit": 25,
    "jsonParameters": false,
    "options": {
      "sortBy": "name",
      "sortOrder": "asc"
    },
    "filters": {
      "filtersUi": {
        "operator": "AND",
        "conditions": {
          "conditionsUi": [
            {
              "field": "name",
              "condition": "Contains",
              "value": "Corp"
            }
          ]
        }
      }
    }
  }
}

Log a follow-up call against a contact:

{
  "type": "salesmate",
  "parameters": {
    "resource": "activity",
    "operation": "create",
    "title": "Follow-up Call",
    "owner": "1",
    "type": "call",
    "additionalFields": {
      "description": "Schedule follow-up call with prospect",
      "dueDate": "{{ $datetime.iso }}",
      "duration": 30,
      "isCalendarInvite": true
    }
  }
}

Create a qualified deal in the Sales pipeline:

{
  "type": "salesmate",
  "parameters": {
    "resource": "deal",
    "operation": "create",
    "title": "Enterprise Software License",
    "owner": "1",
    "primaryContact": "{{ $json.contactId }}",
    "pipeline": "Sales",
    "status": "Open",
    "stage": "Qualified",
    "currency": "USD",
    "additionalFields": {
      "description": "Annual enterprise software license deal",
      "dealValue": 50000,
      "estimatedCloseDate": "2026-03-31",
      "priority": "High",
      "source": "Referrals"
    }
  }
}

Pull every open deal with a raw JSON search body. Filters (JSON) is parsed as text, so give it a JSON string rather than a nested object — an object is silently ignored and the search returns everything:

{
  "type": "salesmate",
  "parameters": {
    "resource": "deal",
    "operation": "getAll",
    "returnAll": true,
    "jsonParameters": true,
    "filtersJson": "{\"query\":{\"group\":{\"operator\":\"AND\",\"conditions\":[{\"field\":\"status\",\"condition\":\"EQUALS\",\"value\":\"Open\"}]}}}"
  }
}

Delete several records in one call:

{
  "type": "salesmate",
  "parameters": {
    "resource": "company",
    "operation": "delete",
    "id": "123,456,789"
  }
}

Error Handling

ModeBehavior
stopHalts workflow on first error
continueSkips failed items, passes successful ones through
errorPortRoutes failed items to Error output port

Tips

Salesmate CRM: create, read, update, delete, and search companies, activities, and deals.

Filtering and Pagination

  • Use returnAll: true to get all records, or returnAll: false with limit for pagination. Limit accepts 1–25 per request.
  • Use jsonParameters: true for complex JSON filters, or jsonParameters: false for the structured filter builder.
  • Filters (JSON) is read as text and parsed. Supply a JSON string; anything that fails to parse is discarded without an error, and the search runs unfiltered.
  • Add Options whenever you list records so you control sorting and which fields come back.

Data Structure Considerations

  • Collection parameters (Additional Fields, Update Fields, Options) are flat objects keyed by the sub-field’s internal name.
  • The Filters fixed collection nests under the group key filtersUi, and its conditions nest under conditionsUi.
  • Set RAW Data to true when you want Salesmate’s field-detail metadata in the response.

Frequently asked questions

What is the pagination limit?

Between 1 and 25 records per request when Return All is off. For everything, set Return All to true and let the node page through.

How do I supply complex filters?

Set jsonParameters true and use Filters (JSON), or leave it false to use the structured filter builder. The JSON field is read as text and parsed, so malformed JSON fails rather than being ignored.

Which resources can it manage?

Companies, activities and deals — the objects most sales workflows touch.

Which credential does it need?

A Salesmate API credential.

Build with the Salesmate node

Drop it into a workflow, wire it to an agent, or call it on a schedule. You'll need Salesmate API credentials first.

Open BusyBot

Last updated . Spotted something wrong? Tell us.