hubspot-list-companies_skill

Overview

This skill lists companies from a HubSpot CRM account and returns a paginated JSON result and human-friendly summary. It is optimized for quick inspection of company records including name, domain, industry, city, employee count, phone, and HubSpot ID. Use it when you need to browse or export a subset of company records from HubSpot.

How this skill works

The skill calls HubSpot's companies API and returns a JSON payload with a results array and optional paging cursor for additional pages. It supports limiting the number of records returned and accepts an 'after' cursor to fetch subsequent pages. Command-line flags control limit and pagination; the skill also provides a formatted display summary for quick reading.

When to use it

• When you need a quick list of companies in HubSpot for review or export
• When you want paginated access to company records with a cursor for large datasets
• When verifying company properties such as domain, industry, city, or employee count
• When troubleshooting integrations that require checking company IDs and URLs
• Before running operations that need a target company ID (e.g., updates or associations)

Best practices

• Run the config pre-flight check before listing to ensure credentials and scopes are valid
• Start with a small limit to preview results, then increase if needed
• Use the 'after' cursor from the paging response to iterate through large result sets
• Handle API rate limits (429) by backing off and retrying; ensure required scopes are granted
• Filter or post-process the JSON output to extract only the fields your workflow needs

Example use cases

• List the first 10 companies to verify recent imports or syncs
• Fetch 25 companies to prepare a marketing outreach list with domains and phone numbers
• Paginate through all companies to generate an external export or audit report
• Locate a company ID quickly before creating associations or updating properties
• Check for missing critical fields (e.g., domain or industry) to clean data