HubSpot

Humm reads your HubSpot contacts, companies, deals, and custom objects. Ask which deals are stalling, which accounts haven’t had activity in 30 days, or what your stage conversion looks like this quarter.

Tools

Tool	Description
`HUBSPOT_READ_OWNERS`	List owners (users) to find IDs for record associations
`HUBSPOT_SEARCH_COMPANIES`	Search companies with advanced filtering and sorting
`HUBSPOT_SEARCH_DEALS`	Search deals with advanced filtering and sorting
`HUBSPOT_SEARCH_CONTACTS`	Search contacts with advanced filtering and sorting
`HUBSPOT_LIST_OBJECTS`	List records for any object type with pagination
`HUBSPOT_READ_RECORDS`	Read one or more records by ID with optional associations
`HUBSPOT_SEARCH_OBJECTS`	Generic search for any object type with filters
`HUBSPOT_QUERY_ASSOCIATIONS`	Batch query associations between object types
`HUBSPOT_LIST_PROPERTIES`	List available properties for an object type
`HUBSPOT_LIST_SCHEMAS`	List custom object schemas to discover objectTypeIds

Filter Groups Syntax

Humm uses HubSpot’s filterGroups structure for advanced searches. Here’s how it works:

Logic

Within a filter group: Conditions are combined with AND
Across filter groups: Groups are combined with OR

Structure

{
  "filterGroups": [
    {
      "filters": [
        {"propertyName": "email", "operator": "CONTAINS_TOKEN", "value": "@acme.com"},
        {"propertyName": "lifecyclestage", "operator": "CONTAINS_TOKEN", "value": "customer"}
      ]
    }
  ]
}

Operators

Operator	Description	Value Type
`EQ`	Equal to (use for strings/numbers, not enumeration properties)	`value`
`NEQ`	Not equal to	`value`
`LT` / `LTE`	Less than / Less than or equal	`value`
`GT` / `GTE`	Greater than / Greater than or equal	`value`
`BETWEEN`	Within range (inclusive)	`value` + `highValue`
`IN` / `NOT_IN`	In list / Not in list	`values` array
`HAS_PROPERTY`	Property has a value	none
`NOT_HAS_PROPERTY`	Property has no value	none
`CONTAINS_TOKEN`	Contains token (preferred for enumeration properties)	`value`
`NOT_CONTAINS_TOKEN`	Does not contain token	`value`

Enumeration Properties

Certain HubSpot properties are “enumeration” types internally and require special handling:

hubspot_owner_id
dealstage
pipeline
lifecyclestage

For these properties, use CONTAINS_TOKEN instead of EQ. Using EQ often returns no results.

// Correct - use CONTAINS_TOKEN for enumeration properties
{"propertyName": "hubspot_owner_id", "operator": "CONTAINS_TOKEN", "value": "12345"}
{"propertyName": "dealstage", "operator": "CONTAINS_TOKEN", "value": "closedwon"}

// Wrong - EQ often fails for enumeration properties
{"propertyName": "hubspot_owner_id", "operator": "EQ", "value": "12345"}

Query Examples

Search companies by owner

{
  "filterGroups": [
    {
      "filters": [
        {"propertyName": "hubspot_owner_id", "operator": "CONTAINS_TOKEN", "value": "12345678"}
      ]
    }
  ],
  "properties": ["name", "domain", "hubspot_owner_id"],
  "limit": 50
}

Search deals in a specific stage

{
  "filterGroups": [
    {
      "filters": [
        {"propertyName": "dealstage", "operator": "CONTAINS_TOKEN", "value": "closedwon"}
      ]
    }
  ],
  "sorts": [{"propertyName": "closedate", "direction": "DESCENDING"}],
  "properties": ["dealname", "amount", "closedate"],
  "limit": 100
}

Search contacts by email domain

{
  "filterGroups": [
    {
      "filters": [
        {"propertyName": "email", "operator": "CONTAINS_TOKEN", "value": "@acme.com"}
      ]
    }
  ],
  "properties": ["firstname", "lastname", "email"],
  "limit": 50
}

Combined filters (AND logic within group)

{
  "filterGroups": [
    {
      "filters": [
        {"propertyName": "pipeline", "operator": "CONTAINS_TOKEN", "value": "default"},
        {"propertyName": "amount", "operator": "GTE", "value": "50000"}
      ]
    }
  ]
}

Multiple filter groups (OR logic across groups)

{
  "filterGroups": [
    {
      "filters": [
        {"propertyName": "lifecyclestage", "operator": "CONTAINS_TOKEN", "value": "customer"}
      ]
    },
    {
      "filters": [
        {"propertyName": "email", "operator": "CONTAINS_TOKEN", "value": "@partner.com"}
      ]
    }
  ]
}

Custom Objects

HubSpot supports custom objects with unique schemas. To work with custom objects:

Discover schemas: Use HUBSPOT_LIST_SCHEMAS to list all custom object schemas and their objectTypeId values (e.g., 2-123456)
List properties: Use HUBSPOT_LIST_PROPERTIES with the objectTypeId to see available fields
Query records: Use HUBSPOT_LIST_OBJECTS or HUBSPOT_SEARCH_OBJECTS with the objectTypeId as the object_type

// List custom object records
{"object_type": "2-123456", "limit": 50, "properties": ["name", "custom_code"]}

// Search custom objects
{
  "object_type": "2-123456",
  "filterGroups": [
    {
      "filters": [
        {"propertyName": "custom_code", "operator": "CONTAINS_TOKEN", "value": "ABC-"}
      ]
    }
  ]
}

Authentication

OAuth

Connect securely via HubSpot OAuth. Authorize Humm to access your HubSpot portal.

Start Here

Key Features

Integrations

Guides

Tools

Filter Groups Syntax

Logic

Structure

Operators

Enumeration Properties

Query Examples

Search companies by owner

Search deals in a specific stage

Search contacts by email domain

Combined filters (AND logic within group)

Multiple filter groups (OR logic across groups)

Custom Objects

Authentication

OAuth

​Tools

​Filter Groups Syntax

​Logic

​Structure

​Operators

​Enumeration Properties

​Query Examples

​Search companies by owner

​Search deals in a specific stage

​Search contacts by email domain

​Combined filters (AND logic within group)

​Multiple filter groups (OR logic across groups)

​Custom Objects

​Authentication

OAuth

Tools

Filter Groups Syntax

Logic

Structure

Operators

Enumeration Properties

Query Examples

Search companies by owner

Search deals in a specific stage

Search contacts by email domain

Combined filters (AND logic within group)

Multiple filter groups (OR logic across groups)

Custom Objects

Authentication