List Companies

Lists companies from HubSpot. Useful for browsing available companies when you do not know a specific company ID.

Action identifier: list_companies. Reference checked: 29 September 2026.

Inputs

Field	Type	Required/default	Meaning
limit	integer	100	The maximum number of companies to return
include_archived	boolean	false	HubSpot archived-record filter; see path-specific behavior below.

Output shape

Paths are relative to this action's output. Select them from the builder's variable picker; do not add a ticket wrapper to actions that return top-level fields. Nullable property fields and empty defaults are not proof that a value was retrieved.

Path	Type	Meaning
results	list of objects	Records returned by this execution; see the retrieval limits below.
results[].id	string	HubSpot record ID.
results[].properties	object	Property values returned for this record; some declared fields may be empty.
results[].properties.name	string | null	The name of the company
results[].properties.domain	string | null	The domain name of the company
results[].properties.phone	string | null	The phone number
results[].properties.address	string | null	The address
results[].properties.city	string | null	The city
results[].properties.state	string | null	The state or region
results[].properties.zip	string | null	The postal code
results[].createdAt	string	Creation timestamp returned by HubSpot; empty when unavailable.
results[].updatedAt	string	Last-update timestamp returned by HubSpot; empty when unavailable.
results[].archived	boolean	Archive flag returned by HubSpot; defaults to false when omitted.
exists	boolean	True when at least one company is returned.

Property objects can contain additional fields returned by HubSpot. The declared fields above are not a promise that every property is populated.

Behavior and limits

Performs one list request; limit is sent as the requested page size. It does not follow pagination or return a cursor. Use a page size accepted by HubSpot rather than expecting a larger limit to fetch the whole portal.

include_archived is passed as HubSpot's archived filter. Treat archived records as a separate filtered read, not an automatic union with active records. No returned records gives exists: false.

Requested properties

This action explicitly requests name, domain, hs_object_id, createdate, hs_lastmodifieddate. Other fields declared in its output model are not automatically fetched.

See Troubleshooting for request errors and retry behavior, or return to the action catalog.