hubspot-list-companies

Lists companies from HubSpot CRM with pagination and JSON output.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-list-companies-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-list-companies
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-list-companies
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-list-companies-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrieving company records from HubSpot CRM normally requires writing API calls, handling authentication, and managing pagination manually. This Skill wraps that workflow into a single command that returns a paginated, structured list of companies. ## Core Features & Use Cases - Paginated Company Listing: Retrieve companies in batches with configurable limits and cursor-based pagination via the HubSpot API. - Pre-Flight Config Check: Validates HubSpot credentials and connection before running, preventing confusing authentication failures. - Structured JSON Output: Returns company properties (name, domain, industry, city, employees, phone) plus direct HubSpot record URLs. - Use Case: A sales operations manager needs a quick overview of all accounts in the CRM. They ask for the company list and receive a formatted summary with domains, industries, and record links without opening the HubSpot UI. ## Quick Start Ask the AI to list companies from HubSpot, optionally specifying how many results to return per page.

Frequently Asked Questions about hubspot-list-companies

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list companies from HubSpot CRM?

Run the list_companies.py script with the --json flag after verifying your HubSpot configuration. It returns a paginated list of companies with properties like name, domain, industry, and employee count.

How to paginate through HubSpot company results?

Pass the cursor value from the paging.next.after field of a previous response using the --after argument. Combine it with --limit to control how many companies are returned per page.

What HubSpot API scope is needed to read companies?

Reading companies requires the crm.objects.companies.read scope on your HubSpot private app token. A 403 error indicates this scope is missing, while a 401 error means the token itself is invalid.

Why does the HubSpot API return a 429 error?

A 429 error means you have hit the HubSpot API rate limit. Wait for the rate limit window to reset and retry the request, or reduce how frequently you call the API.

Can I search HubSpot companies instead of listing all of them?

Listing returns companies in pages without filtering. For targeted lookups by name or domain, use the related hubspot-search-companies skill, which queries specific records rather than browsing the full list.