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

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

Retrieves contact records from HubSpot CRM with customizable properties and filters. Returns contact details including name, email, phone, company, lifecycle stage, and other contact properties.

|                      |                         |
| -------------------- | ----------------------- |
| **App**              | HubSpot                 |
| **Operation ID**     | `hubspot_list_contacts` |
| **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 contact properties to retrieve. Common properties include: firstname, lastname, email, phone, company, website, jobtitle,  lifecyclestage, hs\_lead\_status, createdate, lastmodifieddate. |
| `filters`    | array of FilterItem                 | No       | -       | List of filters to apply to contacts. Each filter must have a field,  operator, and value. Example: filter by email domain, lifecycle stage, 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 contacts 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 contacts.

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