Search Companies (HubSpot)
HubSpot → Search Companies (HubSpot)
/v1/hubspot-search-companies{ "propertyname": "Jane Doe", "operator": "sample-value", "value": "sample-value", "query_string": "sample-value", "sort_by": "sample-value", "sort_direction": "sample-value", "limit": 1 }
{ "ok": true, "data": { "id": "rec_4f3a91", "created_at": "sample", "updated_at": "sample", "archived": true, "domain": "https://acme.com", "name": "sample", "hubspot_owner_id": "rec_4f3a91", "industry": "sample", "type": "sample", "city": "sample", "state": "sample", "zip": "sample", "number_of_employee": 1, "annual_revenue": 1, "timezone": "sample", "description": "sample", "linkedin_company_page": "sample", "about_us": "sample", "close_date": "sample", "country": 1, "employee_range": "sample", "industry_group": "sample", "life_cycle_stage": "sample", "linkedin_handle": "sample", "analytics_source": "sample", "mobile_number": "sample", "quick_context": "sample", "revenue_range": "sample", "state_code": "sample", "address": "sample", "address_2": "sample", "website": "https://acme.com", "founded_year": "sample", "lead_status": "valid", "facebook_company_page": "sample", "facebook_fan": 1, "googleplus_page": "sample", "linkedin_bio": "sample", "twitter_bio": "sample", "twitter_follower": 1, "searchable_calculated_mobile_number": "sample", "pipeline": "sample", "twitter_handle": "sample", "target_account": 1, "total": 1, "next_after": "sample" } }
Search for companies using a text query or specific filters
Install
Add search companies (hubspot) 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__hubspot-search-companies
When to use this.
The "Search Companies (HubSpot)" action enables users to efficiently locate companies within the HubSpot CRM using a text query or specific filters. Key input parameters include 'propertyname' for filtering by attributes like 'domain' or 'name', 'operator' to define the filter's logic, and 'querystring' for broader text searches. Users can also specify sorting options and limit the number of results returned. The action outputs a comprehensive set of company properties, such as ID, name, domain, contact details, industry, and social media links, facilitating informed decision-making. This functionality is ideal for sales teams, marketers, and business analysts looking to identify potential leads, analyze market trends, or manage customer relationships effectively.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Search Companies (HubSpot)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
idIdtextcreated_atCreated Atnullabletextupdated_atUpdated AtnullabletextarchivedArchivednullablebooleandomainDomaintextnameNametexthubspot_owner_idHubspot Owner IdnullabletextindustryIndustrytexttypeTypenullabletextcityCitytextstateStatenullabletextzipZipnullabletextnumber_of_employeeNumber Of Employeenullablenumberannual_revenueAnnual RevenuenullablenumbertimezoneTimezonenullabletextdescriptionDescriptionnullabletextlinkedin_company_pageLinkedin Company Pagenullabletextabout_usAbout Usnullabletextclose_dateClose DatenullabletextcountryCountrytextemployee_rangeEmployee Rangenullabletextindustry_groupIndustry Groupnullabletextlife_cycle_stageLife Cycle Stagenullabletextlinkedin_handleLinkedin Handlenullabletextanalytics_sourceAnalytics Sourcenullabletextmobile_numberMobile Numbernullabletextquick_contextQuick Contextnullabletextrevenue_rangeRevenue Rangenullabletextstate_codeState CodenullabletextaddressAddressnullabletextaddress_2Address 2nullabletextwebsiteWebsitetextfounded_yearFounded Yearnullabletextlead_statusLead Statusnullabletextfacebook_company_pageFacebook Company Pagenullabletextfacebook_fanFacebook Fannullablenumbergoogleplus_pageGoogleplus Pagenullabletextlinkedin_bioLinkedin Bionullabletexttwitter_bioTwitter Bionullabletexttwitter_followerTwitter Followernullablenumbersearchable_calculated_mobile_numberSearchable Calculated Mobile NumbernullabletextpipelinePipelinenullabletexttwitter_handleTwitter Handlenullabletexttarget_accountTarget AccountnullabletexttotalTotalnullablenumbernext_afterNext Afternullabletext
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/hubspot-search-companies. Auth: x-api-key.
/v1/hubspot-search-companiescurl -X POST 'https://v3-api.texau.com/api/v1/hubspot-search-companies' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"propertyname":"Jane Doe","operator":"sample-value","value":"sample-value","query_string":"sample-value","sort_by":"sample-value","sort_direction":"sample-value","limit":1}'
{ "ok": true, "data": { "id": "rec_4f3a91", "created_at": "sample", "updated_at": "sample", "archived": true, "domain": "https://acme.com", "name": "sample", "hubspot_owner_id": "rec_4f3a91", "industry": "sample", "type": "sample", "city": "sample", "state": "sample", "zip": "sample", "number_of_employee": 1, "annual_revenue": 1, "timezone": "sample", "description": "sample", "linkedin_company_page": "sample", "about_us": "sample", "close_date": "sample", "country": 1, "employee_range": "sample", "industry_group": "sample", "life_cycle_stage": "sample", "linkedin_handle": "sample", "analytics_source": "sample", "mobile_number": "sample", "quick_context": "sample", "revenue_range": "sample", "state_code": "sample", "address": "sample", "address_2": "sample", "website": "https://acme.com", "founded_year": "sample", "lead_status": "valid", "facebook_company_page": "sample", "facebook_fan": 1, "googleplus_page": "sample", "linkedin_bio": "sample", "twitter_bio": "sample", "twitter_follower": 1, "searchable_calculated_mobile_number": "sample", "pipeline": "sample", "twitter_handle": "sample", "target_account": 1, "total": 1, "next_after": "sample" } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
crm
List Contacts (HubSpot)
Retrieves all HubSpot contacts with email, name, phone, company, and custom properties.
Get Contact (HubSpot)
Retrieves a specific HubSpot contact by ID with all standard, demographic, and custom properties.
Create Company (HubSpot)
Creates a new company record in HubSpot with firmographic properties and optional associations.
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 companies (hubspot) → 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 limit100 / min
- Per-day limit24,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 HubSpot actions.
List Contacts (HubSpot)
Retrieves all HubSpot contacts with email, name, phone, company, and custom properties.
Get Contact (HubSpot)
Retrieves a specific HubSpot contact by ID with all standard, demographic, and custom properties.
Create Company (HubSpot)
Creates a new company record in HubSpot with firmographic properties and optional associations.
Search Contacts (HubSpot)
Search for HubSpot CRM contacts by email address or other filters and retrieve their properties.
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__hubspot-...` 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 Companies (HubSpot) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.