Search Contacts (LeadConnector)
Search and filter contacts using advanced criteria, sorting, and standard pagination
GoHighLevelWhat it needs.
Map each field to a column in your table. Optional fields can stay empty.
queryGeneral search string (Max 75 chars). Tests against configured searchable fields.nullabletextlimitEnter the number of contacts to search (must be multiple of 25)nullablenumberfilter_1_fieldThe field to apply the first filter to.nullableselectfilter_1_operatorThe comparison operator for the first filter.nullableselectfilter_1_valueThe value to filter by.nullabletextsort_byThe field to sort the results by.nullableselectsort_directionAscending or Descending.nullableselect
When to use this.
The "Search Contacts (LeadConnector)" action allows users to efficiently search and filter contacts within a CRM system using advanced criteria, sorting options, and standard pagination. Key input parameters include a customizable search query, limit on the number of contacts returned (in multiples of 25), and various filters such as field selection, comparison operators, and sorting preferences. The action outputs comprehensive metadata, including contact details like name, email, phone, company information, and attribution sources, enabling users to access deep insights into their contacts. This functionality is essential for sales and marketing teams looking to segment leads, track engagement, and optimize outreach strategies. It falls under the categories of CRM and integration, making it a vital tool for enhancing customer relationship management and data-driven decision-making.
What it returns.
Every field this action writes back to the row. Click a line to expand nested objects.
successSuccessnullablebooleantotalTotalnullablenumbertrace_idTrace Idnullabletextcontact_idContact Idtextlocation_idLocation IdnullabletexttypeTypenullabletextcontact_nameContact Nametextfirst_nameFirst Namenullabletextfirst_name_lower_caseFirst Name Lower Casenullabletextlast_nameLast Namenullabletextlast_name_lower_caseLast Name Lower CasenullabletextemailEmailtextemail_lower_caseEmail Lower Casenullabletextadditional_emailAdditional Emailnullabletextvalid_emailValid Emailnullablebooleanmobile_numberMobile Numbertextadditional_mobile_numberAdditional Mobile Numbernullabletextmobile_number_labelMobile Number Labelnullabletextcompany_nameCompany Nametextbusiness_nameBusiness Namenullabletextbusiness_idBusiness Idnullabletextassigned_toAssigned TonullabletextaddressAddressnullabletextcityCitytextstateStatenullabletextcountryCountrytextpostal_codePostal CodenullabletextwebsiteWebsitenullabletextsourceSourcenullabletexttimezoneTimezonenullabletextdate_of_birthDate Of Birthnullabletextdate_addedDate Addednullabletextdate_updatedDate UpdatednullabletextdndDndnullablebooleandnd_call_statusDnd Call Statusnullabletextdnd_email_statusDnd Email Statusnullabletextdnd_sms_statusDnd Sms Statusnullabletextdnd_whatsapp_statusDnd Whatsapp Statusnullabletextdnd_gmb_statusDnd Gmb Statusnullabletextdnd_fb_statusDnd Fb Statusnullabletextinbound_dnd_all_statusInbound Dnd All StatusnullabletexttagTagtextfollowerFollowernullabletextcustom_field_idCustom Field Idnullabletextcustom_field_valueCustom Field Valuenullabletextopportunity_idOpportunity Idnullabletextopportunity_pipeline_idOpportunity Pipeline Idnullabletextopportunity_stage_idOpportunity Stage Idnullabletextopportunity_monetary_valueOpportunity Monetary Valuenullablenumberopportunity_statusOpportunity Statusnullabletextsearch_afterSearch Afternullabletextattr_utm_sourceAttr Utm Sourcenullabletextattr_utm_keywordAttr Utm Keywordnullabletextattr_session_sourceAttr Session Sourcenullabletextattr_campaignAttr Campaignnullabletextattr_utm_mediumAttr Utm Mediumnullabletextattr_urlAttr Urlnullabletextattr_referrerAttr Referrernullabletextlast_attr_utm_sourceLast Attr Utm Sourcenullabletextlast_attr_utm_keywordLast Attr Utm Keywordnullabletextlast_attr_session_sourceLast Attr Session Sourcenullabletextlast_attr_campaignLast Attr Campaignnullabletextlast_attr_utm_mediumLast Attr Utm Mediumnullabletextlast_attr_urlLast Attr Urlnullabletextlast_attr_referrerLast Attr Referrernullabletext
How this fits a workflow.
Trigger → Search Contacts (LeadConnector) → enrich → push to your CRM. You set it up once; after that it runs without you.
- Step 1TriggerNew row, form submit, or schedule.
- Step 2Search Contacts (LeadConnector)The GoHighLevel action runs.
- Step 3EnrichWaterfall fills missing fields.
- Step 4Push to CRMHubSpot / Pipedrive / Zoho CRM / GoHighLevel.
Two actions you can chain after this one:
Throughput & reliability.
How fast it drains a table, and what happens when the upstream provider has a bad day.
- Per-minute limit60 / min
- Per-day limit10,000 / day
- RetriesAutomatic w/ backoff
- Failed lookupsZero credits
More GoHighLevel actions.
crm
Update Opportunity Status (LeadConnector)
Update the status of a specific opportunity in LeadConnector.
Get Business/Company (LeadConnector)
Retrieves the details of a specific standalone Business (Company) record using its ID.
Create Business/Company (LeadConnector)
Creates a new standalone Business (Company) record in GoHighLevel.
Upsert Opportunity (LeadConnector)
Create a new opportunity or update an existing one using the Upsert endpoint in LeadConnector.
FAQ.
Run Search Contacts (LeadConnector) in 60 seconds.
Connect the account, drop the action on a column, run it on your rows.