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

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

Retrieves deal records from HubSpot CRM with customizable properties and filters. Returns deal details including deal name, amount, stage, pipeline, close date, and other deal properties.

|                      |                      |
| -------------------- | -------------------- |
| **App**              | HubSpot              |
| **Operation ID**     | `hubspot_list_deals` |
| **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 deal properties to retrieve. Common properties include: dealname, amount, dealstage, pipeline, closedate, createdate,  hs\_priority, dealtype, description, num\_associated\_contacts. |
| `filters`    | array of FilterItem                 | No       | -       | List of filters to apply to deals. Each filter must have a field,  operator, and value. Example: filter by deal stage, amount, pipeline, 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 deals 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 deals.

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