> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Companies

> Retrieves company records from HubSpot CRM with customizable properties and filters

Retrieves company records from HubSpot CRM with customizable properties and filters. Returns company details including name, domain, industry, location, employee count, revenue, and other company properties.

|                      |                          |
| -------------------- | ------------------------ |
| **App**              | HubSpot                  |
| **Operation ID**     | `hubspot_list_companies` |
| **Type**             | Action                   |
| **Connection**       | `hubspot` (required)     |
| **Credits per run**  | 1                        |
| **Agent / MCP tool** | Yes                      |

## Inputs

| Field        | Type                                | Required | Default | Description                                                                                                                                                                                          |
| ------------ | ----------------------------------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `properties` | array of string or SelectableOption | Yes      | -       | List of company properties to retrieve. Common properties include: name, domain, industry, city, state, country, phone, website, numberofemployees, annualrevenue, createdate, hs\_lastmodifieddate. |
| `filters`    | array of FilterItem                 | No       | -       | List of filters to apply to companies. Each filter must have a field,  operator, and value. Example: filter by industry, city, revenue, etc.                                                         |
| `orders`     | array of OrderItem                  | No       | -       | List of fields to sort the report by. Each order must have a `field` and `direction`. The field must be one of the current selected properties.                                                      |
| `limit`      | integer                             | No       | `10000` | Maximum number of companies to return. Default is 10000, maximum is 100000.                                                                                                                          |

### FilterItem

| Field      | Type                       | Required | Default | Description                                                                                                                                                   |
| ---------- | -------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `field`    | string or SelectableOption | Yes      | -       | The field to filter on, must be one of the current selected metrics or dimensions.                                                                            |
| `operator` | string                     | Yes      | -       | The operator to use for filtering. Must be one of the supported values. Use REGEXP\_MATCH to search/filter by multiple OR values like '.*(summer\|holiday).*' |
| `value`    | string                     | Yes      | -       | The value to filter by. Can be a string, number, regex, or a list of strings.                                                                                 |

### OrderItem

| Field       | Type                       | Required | Default | Description                                                                      |
| ----------- | -------------------------- | -------- | ------- | -------------------------------------------------------------------------------- |
| `field`     | string or SelectableOption | Yes      | -       | The field to sort by. must be one of the current selected metrics or dimensions. |
| `direction` | string                     | Yes      | -       | The order to sort by, must be one of 'ASC', 'DESC'                               |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `List[Dict]`

Returns list of companies.

**Fields**: dynamic (depend on the inputs)