FlowmageDocs

Find contacts

BetaReads data

Lists or searches Freshdesk contacts.

Settings

SettingWhat it is
ConnectionRequiredThe Freshdesk connection the step signs in with.
How to find them"list" or "search"
E-mailtext
Mobiletext
Phonetext
Company idtext
State"" or "blocked" or "deleted" or "unverified" or "verified"
Updated sincetext
QueryFreshdesk searches contacts on name, email, phone, mobile, company_id, state, created_at, updated_at and any custom field by name. A query may be 512 characters and answers at most 10 pages of 30.
Contacts per call1 to 100. A filter query always answers pages of 30.
Fetch every pageRefuses past 5,000 contacts rather than answering a short list. A query stops at 10 pages of 30 whatever you set.
Pages at most1 to 10.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `freshdesk`)
mode"list" or "search", by default "list"
emailtextused when `mode` is "list"
mobiletextused when `mode` is "list"
phonetextused when `mode` is "list"
companyIdtextused when `mode` is "list"
state"" or "blocked" or "deleted" or "unverified" or "verified"used when `mode` is "list"
updatedSincetextused when `mode` is "list"
querytextused when `mode` is "search"
limitnumber, by default 100
returnAlltrue/false, by default false
maxPagesnumber, by default 10used when `mode` is "search"

Output

FieldType
contactsarray
contactCountContacts in this answernumber
totalMatches Freshdesk counted (a query only)number
hasMoreMore contacts are waiting behind this pageboolean
nextUrlFreshdesk's link to the next pagestring
Sample output, and the expression for each field
  • contactCount0
  • contacts[]
  • hasMorefalse
  • nextUrl""
  • total0

Errors

When a step of this node stops a run, the run page shows a code. Look it up:

Example step

The step as a flow file holds it. Replace each value in <…>.

{
  "config": {
    "companyId": "",
    "connection": "<connection id>",
    "email": "",
    "limit": 100,
    "maxPages": 10,
    "mobile": "",
    "mode": "list",
    "phone": "",
    "query": "",
    "returnAll": false,
    "state": "",
    "updatedSince": ""
  },
  "label": "Find contacts",
  "type": "freshdesk.findContacts",
  "version": 1
}