> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/hubspot-integration-in-automations/actions/list-deals.md).

# List Deals

Lists deals from HubSpot. Optionally lists only the deals connected to a specific company or contact.

**Action identifier:** `list_deals`. **Reference checked:** 29 September 2026.

## Inputs

| Field                   | Type           | Required/default | Meaning                                                           |
| ----------------------- | -------------- | ---------------- | ----------------------------------------------------------------- |
| `limit`                 | integer        | `100`            | The maximum number of deals to return                             |
| `include_archived`      | boolean        | `false`          | HubSpot archived-record filter; see path-specific behavior below. |
| `associated_company_id` | string \| null | `null`           | Only list deals associated with this company                      |
| `associated_contact_id` | string \| null | `null`           | Only list deals associated with this contact                      |

## 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.dealname`  | string \| null  | The name of the deal                                                         |
| `results[].properties.amount`    | string \| null  | The monetary amount of the deal                                              |
| `results[].properties.dealstage` | string \| null  | The current stage of the deal                                                |
| `results[].properties.pipeline`  | string \| null  | The pipeline ID                                                              |
| `results[].properties.closedate` | string \| null  | The close date of the deal                                                   |
| `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 deal 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

With no association filter, performs one list request and passes `include_archived` as the `archived` filter. It does not follow pagination.

With a company or contact filter, reads one association page and batch-reads up to `limit` associated deals. The company filter wins if both IDs are supplied; the filters are not combined. `include_archived` is not used in this association-filtered path. Association and batch-read limits still apply.

No returned deals gives `exists: false`. A positive limit is expected.

### Requested properties

This action explicitly requests `dealname`, `dealstage`, `pipeline`, `amount`, `closedate`, `createdate`, `hs_object_id`. Other fields declared in its output model are not automatically fetched.

See [Troubleshooting](/ebbot-docs/integrations/automations-integrations/integration-setup-guides/hubspot-integration-in-automations/troubleshooting.md) for request errors and retry behavior, or return to the [action catalog](/ebbot-docs/integrations/automations-integrations/integration-setup-guides/hubspot-integration-in-automations/actions.md).