Skip to main content

Documentation Index

Fetch the complete documentation index at: https://heyhumm.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Humm queries your Attio people, companies, and deals. Ask about pipeline, contact activity, or filter your CRM data with Attio’s flexible query syntax.

​
Source Types

SaaS (Live)

Humm queries the Attio API directly in real time. Data is never stored by Humm.

Sync

Humm syncs your Attio data into your warehouse via Airbyte, then queries the copy. Better performance and lets you join CRM data with everything else in your warehouse.
See Choosing a Source Type for help deciding.

​
Tools

ToolDescription
ATTIO_LIST_RECORDSList records for an object type (people, companies, deals) with filtering and sorting
ATTIO_READ_RECORDGet a record by ID and object type
ATTIO_LIST_WORKSPACE_MEMBERSList all members of the Attio workspace

​
Filter and Sort Examples

Humm uses Attio’s filter syntax to query records. Here are common patterns: 
# List all people
object: "people"

# Filter by name
object: "people"
filter: {"name": "Ada Lovelace"}

# Filter with OR conditions
object: "people"
filter: {
  "$or": [
    {"name": {"first_name": {"$eq": "David"}}},
    {"name": {"first_name": {"$eq": "Steve"}}}
  ]
}

# Sort by last name ascending
object: "people"
sorts: [{"direction": "asc", "attribute": "name", "field": "last_name"}]

# Sort by creation date descending
object: "companies"
sorts: [{"direction": "desc", "attribute": "created_at"}]

# Pagination
object: "deals"
limit: 100
offset: 0

​
Object Types

Attio supports querying different object types:
  • people - Contact records with names, emails, and custom fields
  • companies - Organization records with company details
  • deals - Deal/opportunity records for pipeline tracking
Use the object slug (e.g., "people", "companies", "deals") or UUID to specify which object type to query.

​
Authentication

OAuth

Connect securely via Attio OAuth. Authorize Humm to access your Attio workspace.