> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot Changelog

> Release history for the HubSpot connector. Each version lists what changed and which actions were affected.

<Card title="HubSpot connector" icon="arrow-left" href="/connectors/hubspot" horizontal>
  Back to the connector overview, authentication methods, and actions.
</Card>

<Update label="v3.1.0" description="17 Aug 2026">
  `bug-fix` `improvement`

  Added the IN, NOT\_IN, and BETWEEN filter operators to the Search Contacts, Search Deals, and Search Tickets actions (Search Companies already supported them). IN/NOT\_IN match a property against a list of values via the new `values` array, and BETWEEN matches a range via `value` (lower bound) and the new `highValue` (upper bound) — e.g. filtering by a list of hs\_object\_id values, which previously returned no results. Also raised the search page-size limit to 200 and documented HubSpot's 10,000-record search ceiling, and enriched the search filter documentation across all object types (filter-group limits, epoch-millisecond date values, IN/NOT\_IN lowercase-string rule, CONTAINS\_TOKEN wildcard support, and single-sort behavior). Fixed Search Contacts, Search Deals, and Search Tickets so a criteria-less search (empty body) returns all records instead of failing with HTTP 415 (Search Companies already behaved this way).

  <AccordionGroup>
    <Accordion title="Changed · 4 actions updated">
      `hubspot_search_companies`, `hubspot_search_contacts`, `hubspot_search_deals`, `hubspot_search_tickets`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v3.0.0" description="13 Aug 2026">
  `breaking-change` `bug-fix` `improvement`

  Breaking: company, CRM-object, and deal-pipeline/stage action responses are now wrapped under a top-level `data` key for a consistent response shape. Also fixed empty-body company searches (no longer error) and empty deal-pipeline updates (now rejected up front with a clear message), typed deal-stage metadata so `probability` is enforced, and removed the optional custom pipeline/stage ID inputs from create-deal-pipeline (HubSpot now assigns these automatically) to avoid intermittent provider errors.

  <AccordionGroup>
    <Accordion title="Changed · 21 actions updated">
      `hubspot_batch_create_companies`, `hubspot_batch_update_companies`, `hubspot_create_company`, `hubspot_create_crm_object`, `hubspot_create_deal_pipeline`, `hubspot_create_deal_pipeline_stage`, `hubspot_delete_company`, `hubspot_delete_crm_object`, `hubspot_get_company`, `hubspot_get_crm_object`, `hubspot_get_deal_pipeline`, `hubspot_get_deal_pipeline_stage`, `hubspot_list_companies`, `hubspot_list_crm_objects`, `hubspot_list_deal_pipeline_stages`, `hubspot_list_deal_pipelines`, `hubspot_search_companies`, `hubspot_update_company`, `hubspot_update_crm_object`, `hubspot_update_deal_pipeline`, `hubspot_update_deal_pipeline_stage`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.1.2" description="7 Aug 2026">
  `bug-fix` `improvement`

  Fixed group, organization, and role lookups returning empty results instead of not-found errors.

  <AccordionGroup>
    <Accordion title="Changed · 3 actions updated">
      `hubspot_unified_get_group`, `hubspot_unified_get_organization`, `hubspot_unified_get_role`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.1.1" description="30 Jul 2026">
  `bug-fix`

  Fixed IAM actions — get-by-id now returns an empty record instead of failing, role and group scopes carry the connection's real portal id so they match the organization record, and nested role and group type fields return the full value and source value pair.

  <AccordionGroup>
    <Accordion title="Changed · 9 actions updated">
      `hubspot_unified_get_group`, `hubspot_unified_get_me`, `hubspot_unified_get_organization`, `hubspot_unified_get_role`, `hubspot_unified_get_user`, `hubspot_unified_list_groups`, `hubspot_unified_list_organizations`, `hubspot_unified_list_roles`, `hubspot_unified_list_users`
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="v2.1.0" description="20 Jul 2026">
  `new-actions`

  Added unified IAM actions for users, groups, organizations, roles, and credentials.
</Update>