Search Contacts (LeadConnector)
GoHighLevel → Search Contacts (LeadConnector)
/v1/gohighlevel-search-contacts{ "query": "sample-value", "limit": 1, "filter_1_field": "sample-value", "filter_1_operator": "sample-value", "filter_1_value": "sample-value", "sort_by": "sample-value", "sort_direction": "sample-value" }
{ "ok": true, "data": { "success": true, "total": 1, "trace_id": "rec_4f3a91", "contact_id": "rec_4f3a91", "location_id": "rec_4f3a91", "type": "sample", "contact_name": "sample", "first_name": "sample", "first_name_lower_case": "sample", "last_name": "sample", "last_name_lower_case": "sample", "email": "[email protected]", "email_lower_case": "[email protected]", "additional_email": "[email protected]", "valid_email": "[email protected]", "mobile_number": "sample", "additional_mobile_number": "sample", "mobile_number_label": "sample", "company_name": "sample", "business_name": "sample", "business_id": "rec_4f3a91", "assigned_to": "sample", "address": "sample", "city": "sample", "state": "sample", "country": 1, "postal_code": "sample", "website": "https://acme.com", "source": "sample", "timezone": "sample", "date_of_birth": "sample", "date_added": "sample", "date_updated": "sample", "dnd": true, "dnd_call_status": "valid", "dnd_email_status": "[email protected]", "dnd_sms_status": "valid", "dnd_whatsapp_status": "valid", "dnd_gmb_status": "valid", "dnd_fb_status": "valid", "inbound_dnd_all_status": "valid", "tag": "sample", "follower": "sample", "custom_field_id": "rec_4f3a91", "custom_field_value": "sample", "opportunity_id": "rec_4f3a91", "opportunity_pipeline_id": "rec_4f3a91", "opportunity_stage_id": "rec_4f3a91", "opportunity_monetary_value": 1, "opportunity_status": "valid", "search_after": "sample", "attr_utm_source": "sample", "attr_utm_keyword": "sample", "attr_session_source": "sample", "attr_campaign": "sample", "attr_utm_medium": "sample", "attr_url": "https://acme.com", "attr_referrer": "sample", "last_attr_utm_source": "sample", "last_attr_utm_keyword": "sample", "last_attr_session_source": "sample", "last_attr_campaign": "sample", "last_attr_utm_medium": "sample", "last_attr_url": "https://acme.com", "last_attr_referrer": "sample" } }
Search and filter contacts using advanced criteria, sorting, and standard pagination
Install
Add search contacts (leadconnector) to your MCP client.
Drop this into claude_desktop_config.json (or your client's equivalent) and the tool shows up in any chat.
{ "mcpServers": { "texau": { "command": "npx", "args": ["-y", "@texau/mcp-server"], "env": { "TEXAU_API_KEY": "..." } } } }
Tool name: texau__gohighlevel-search-contacts
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.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Search Contacts (LeadConnector)
Response
Output schema.
Every field returned in `data`. Click rows 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
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/gohighlevel-search-contacts. Auth: x-api-key.
/v1/gohighlevel-search-contactscurl -X POST 'https://v3-api.texau.com/api/v1/gohighlevel-search-contacts' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"query":"sample-value","limit":1,"filter_1_field":"sample-value","filter_1_operator":"sample-value","filter_1_value":"sample-value","sort_by":"sample-value","sort_direction":"sample-value"}'
{ "ok": true, "data": { "success": true, "total": 1, "trace_id": "rec_4f3a91", "contact_id": "rec_4f3a91", "location_id": "rec_4f3a91", "type": "sample", "contact_name": "sample", "first_name": "sample", "first_name_lower_case": "sample", "last_name": "sample", "last_name_lower_case": "sample", "email": "[email protected]", "email_lower_case": "[email protected]", "additional_email": "[email protected]", "valid_email": "[email protected]", "mobile_number": "sample", "additional_mobile_number": "sample", "mobile_number_label": "sample", "company_name": "sample", "business_name": "sample", "business_id": "rec_4f3a91", "assigned_to": "sample", "address": "sample", "city": "sample", "state": "sample", "country": 1, "postal_code": "sample", "website": "https://acme.com", "source": "sample", "timezone": "sample", "date_of_birth": "sample", "date_added": "sample", "date_updated": "sample", "dnd": true, "dnd_call_status": "valid", "dnd_email_status": "[email protected]", "dnd_sms_status": "valid", "dnd_whatsapp_status": "valid", "dnd_gmb_status": "valid", "dnd_fb_status": "valid", "inbound_dnd_all_status": "valid", "tag": "sample", "follower": "sample", "custom_field_id": "rec_4f3a91", "custom_field_value": "sample", "opportunity_id": "rec_4f3a91", "opportunity_pipeline_id": "rec_4f3a91", "opportunity_stage_id": "rec_4f3a91", "opportunity_monetary_value": 1, "opportunity_status": "valid", "search_after": "sample", "attr_utm_source": "sample", "attr_utm_keyword": "sample", "attr_session_source": "sample", "attr_campaign": "sample", "attr_utm_medium": "sample", "attr_url": "https://acme.com", "attr_referrer": "sample", "last_attr_utm_source": "sample", "last_attr_utm_keyword": "sample", "last_attr_session_source": "sample", "last_attr_campaign": "sample", "last_attr_utm_medium": "sample", "last_attr_url": "https://acme.com", "last_attr_referrer": "sample" } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
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.
Output
Results land in a TexAu table.
Sample rows below.
Real result preview coming soon.
| Input | Status | Score |
|---|---|---|
| [email protected] | valid | 96 |
| [email protected] | risky | 54 |
| [email protected] | invalid | 12 |
Workflow
A real example.
Trigger → search contacts (leadconnector) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.
Built for
Who runs this.
Reliability
Rate limits & reliability.
- Per-minute limit60 / min
- Per-day limit10,000 / day
- RetriesAutomatic w/ backoff
- ModeSync
Errors
HTTP status codes.
What each response means and what to do about it.
| Code | Cause | Fix |
|---|---|---|
| 200 OK | Action ran. Data in `data`. | Read response. |
| 400 Bad Request | Missing or malformed input. | Validate against the input schema. |
| 401 Unauthorized | Missing or invalid `x-api-key`. | Re-issue from /api-platform. |
| 403 Forbidden | Workspace lacks plan tier. | Upgrade or contact sales. |
| 404 Not Found | Action key not recognized. | Verify the slug. |
| 429 Rate Limited | Per-minute or per-day cap hit. | Backoff; reduce concurrency. |
| 500 Server Error | Unexpected TexAu issue. | Retry with backoff. |
| 502 Bad Gateway | Upstream provider 5xx. | Retry; we surface root cause. |
| 504 Timeout | Upstream slower than maxLatency. | Switch to `isAsync` polling. |
Related
More GoHighLevel actions.
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.
Is this real-time?
Yes. Synchronous actions return in ~1–4 s. Long-running work uses async polling (see status 504 → switch to async).
Do I get charged on failure?
No. Verified failures cost zero credits. Provider miss / 5xx / timeout cascade to the next provider in the waterfall when applicable.
Does it work with Claude / Cursor via MCP?
Yes. Add the texau MCP server to your client config, then call `texau__gohighlevel-...` directly.
What CRMs can I push results to?
HubSpot, Salesforce, Pipedrive, Zoho, and GoHighLevel are bidirectional. Smartlead, Instantly, Lemlist, HeyReach, Apollo Sequences, and Reply.io for outbound.
Run Search Contacts (LeadConnector) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.