View as Markdown
Less Annoying CRM icon

Less Annoying CRM ACTION

Search Contacts

Searches contacts and companies in Less Annoying CRM by free text (name, email, phone, etc.), with optional filters for record type, owner, and sorting. With no search terms it lists records. Use this to find a contactId before calling Get Contact, Get Contact Activities, Update Contact, Create Note, Create Task, or Create Pipeline Item. For "my contacts", get the user ID from List Users and pass it in ownerIds. advancedFilters is an optional JSON array of {"Name": field, "Operation": op, "Value": value} objects; see the filter docs for valid operations. Returns results plus hasMoreResults; if true, call again with page incremented. Each result is trimmed to ContactId, IsCompany, Name, Company Name, Job Title, Email, Phone, AssignedTo, and LastUpdate; pass fields (e.g. ["Address", "Background Info"]) to get other fields too, or use Get Contact for the full record. Example: searchTerms: "jane@acme.com" returns {"hasMoreResults": false, "results": [{"ContactId": "1234567890123456789012345678901", "IsCompany": false, "Name": {"FirstName": "Jane", "LastName": "Smith"}, "Email": [{"Text": "jane@acme.com", "Type": "Work"}], ...}]}. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Less Annoying CRM account once, then configure and run Search Contacts from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "less_annoying_crm-search-contacts",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    less_annoying_crm: { authProvisionId: "apn_xxxxxxx" },
    searchTerms: "Search Terms",
    recordType: "Record Type",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Contacts inputs
Property Type Description
searchTerms Search Terms string
Text to match against contact/company fields, e.g. Jane Smith or jane@acme.com.
Optional
recordType Record Type string
Limit results to people or companies, e.g. Companies. Omit for both.
Optional
ownerIds Owner User IDs string[]
Only return records assigned to these user IDs, e.g. ["1240220"]. Use List Users to find IDs (the UserId field).
Optional
sortBy Sort By string
Field to sort results by, e.g. LastUpdate. Defaults to Relevance.
Optional
sortDirection Sort Direction string
Sort order, e.g. Ascending. Defaults to Descending.
Optional
advancedFilters Advanced Filters string
JSON array of filters, e.g. [{"Name": "DateCreated", "Operation": "GreaterThan", "Value": "2025-01-01"}].
Optional
fields Extra Fields string[]
Additional record fields to include beyond the default set, e.g. ["Address", "Background Info", "Website", "DateCreated"]. Custom field names are also accepted.
Optional
maxResults Max Results integer
Maximum number of results to return per call (e.g. 50; default 50, max 10000).
Optional
page Page integer
Page of results to return, starting at 1, e.g. 2. Increment while the response has hasMoreResults: true.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
less_annoying_crm-search-contacts
Version
0.0.1
App
Less Annoying CRM
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes