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 for request errors and retry behavior, or return to the action catalog.