List Contacts - Markifact

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.

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)