> ## 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, always as a string: text, a number, or a regex. For IN\_LIST and NOT\_IN\_LIST, pass the values as one comma-separated string such as 'a,b,c', not as an array. |

### 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)