Hubspot logo

List Companies (HubSpot)

HubSpotList Companies (HubSpot)

POST/v1/hubspot-list-companies
texau__hubspot-list-companiescrm
cURL · api.texau.app
84ms
POST/v1/hubspot-list-companies
{
  "limit": 1
}
200 Accepted
{
  "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,
    "next_page_cursor": "sample"
  }
}

Retrieves a paginated list of companies from HubSpot CRM

Install

Add list 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.

claude_desktop_config.json
{
  "mcpServers": {
    "texau": {
      "command": "npx",
      "args": ["-y", "@texau/mcp-server"],
      "env": { "TEXAU_API_KEY": "..." }
    }
  }
}

Tool name: texau__hubspot-list-companies

When to use this.

The "List Companies (HubSpot)" action retrieves a paginated list of companies from HubSpot CRM, providing users with access to a wealth of information including both standard and custom properties. Users can specify an optional input parameter, "limit," to control the maximum number of results displayed per page, enhancing the efficiency of data retrieval. The output includes essential company details such as ID, name, domain, industry, and various contact information, along with additional attributes like lifecycle stage and social media links. This action is particularly useful for CRM management, lead generation, and market analysis, enabling businesses to maintain an organized database of company profiles. It falls under the CRM category, making it an invaluable tool for sales and marketing teams looking to optimize their outreach and engagement strategies.

Try it

Run a sample request.

The response is a deterministic, cached example. No live call, no credits used.

List Companies (HubSpot)

Try it

The maximum number of results to display per page.

Response is cached — no live API call.

Response

Output schema.

Every field returned in `data`. Click rows to expand nested objects.

FieldType
  • id
    Id
    text
  • created_at
    Created At
    nullabletext
  • updated_at
    Updated At
    nullabletext
  • archived
    Archived
    nullableboolean
  • domain
    Domain
    text
  • name
    Name
    text
  • hubspot_owner_id
    Hubspot Owner Id
    nullabletext
  • industry
    Industry
    text
  • type
    Type
    nullabletext
  • city
    City
    text
  • state
    State
    nullabletext
  • zip
    Zip
    nullabletext
  • number_of_employee
    Number Of Employee
    nullablenumber
  • annual_revenue
    Annual Revenue
    nullablenumber
  • timezone
    Timezone
    nullabletext
  • description
    Description
    nullabletext
  • linkedin_company_page
    Linkedin Company Page
    nullabletext
  • about_us
    About Us
    nullabletext
  • close_date
    Close Date
    nullabletext
  • country
    Country
    text
  • employee_range
    Employee Range
    nullabletext
  • industry_group
    Industry Group
    nullabletext
  • life_cycle_stage
    Life Cycle Stage
    nullabletext
  • linkedin_handle
    Linkedin Handle
    nullabletext
  • analytics_source
    Analytics Source
    nullabletext
  • mobile_number
    Mobile Number
    text
  • quick_context
    Quick Context
    nullabletext
  • revenue_range
    Revenue Range
    nullabletext
  • state_code
    State Code
    nullabletext
  • address
    Address
    nullabletext
  • address_2
    Address 2
    nullabletext
  • website
    Website
    text
  • founded_year
    Founded Year
    nullabletext
  • lead_status
    Lead Status
    nullabletext
  • facebook_company_page
    Facebook Company Page
    nullabletext
  • facebook_fan
    Facebook Fan
    nullablenumber
  • googleplus_page
    Googleplus Page
    nullabletext
  • linkedin_bio
    Linkedin Bio
    nullabletext
  • twitter_bio
    Twitter Bio
    nullabletext
  • twitter_follower
    Twitter Follower
    nullablenumber
  • searchable_calculated_mobile_number
    Searchable Calculated Mobile Number
    nullabletext
  • pipeline
    Pipeline
    nullabletext
  • twitter_handle
    Twitter Handle
    nullabletext
  • target_account
    Target Account
    nullabletext
  • next_page_cursor
    Next Page Cursor
    nullabletext

Integrate

Copy-pasteable snippets.

Real endpoint: https://v3-api.texau.com/api/v1/hubspot-list-companies. Auth: x-api-key.

cURL · api.texau.app
84ms
POST/v1/hubspot-list-companies
curl -X POST 'https://v3-api.texau.com/api/v1/hubspot-list-companies' \
  -H 'x-api-key: $TEXAU_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"limit":1}'
200 Accepted
{
  "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,
    "next_page_cursor": "sample"
  }
}

Output

Results land in a TexAu table.

Sample rows below.

Real result preview coming soon.

InputStatusScore
[email protected]valid96
[email protected]risky54
[email protected]invalid12

Workflow

A real example.

Trigger → list companies (hubspot) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.

Step 1TriggerNew row, webhook, or schedule.
Step 2List Companies (HubSpot)HubSpot action runs.
Step 3EnrichWaterfall fills missing fields.
Step 4Push to CRMHubSpot / Salesforce / Pipedrive.

Built for

Who runs this.

GTM EngineerRevOpsAgency

Reliability

Rate limits & reliability.

  • Per-minute limitNo public cap
  • Per-day limitPlan-defined
  • RetriesAutomatic w/ backoff
  • ModeSync

Errors

HTTP status codes.

What each response means and what to do about it.

CodeCauseFix
200 OKAction ran. Data in `data`.Read response.
400 Bad RequestMissing or malformed input.Validate against the input schema.
401 UnauthorizedMissing or invalid `x-api-key`.Re-issue from /api-platform.
403 ForbiddenWorkspace lacks plan tier.Upgrade or contact sales.
404 Not FoundAction key not recognized.Verify the slug.
429 Rate LimitedPer-minute or per-day cap hit.Backoff; reduce concurrency.
500 Server ErrorUnexpected TexAu issue.Retry with backoff.
502 Bad GatewayUpstream provider 5xx.Retry; we surface root cause.
504 TimeoutUpstream slower than maxLatency.Switch to `isAsync` polling.

Pricing

What it costs to run.

Light tier

Pricing tier on /pricing. Per-action credit cost is private.

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 List Companies (HubSpot) in 60 seconds.

Pull your API key, paste the cURL, ship to your CRM.