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

# Integrations

> Connect your data sources so Humm can answer questions about your customers.

Integrations connect Humm to the tools and data you already use. Once connected, Humm can pull from these sources to answer your questions — no exports or spreadsheets needed.

<Tip>
  Start with one or two key sources, then add more over time. The more you connect, the more complete Humm's picture of your customers.
</Tip>

***

## Choosing a Source Type

Humm connects to data in three ways. Pick the one that fits how your data is set up.

### Database

Humm queries your data warehouse directly (Snowflake, BigQuery, Athena, Databricks, PostgreSQL, MySQL). This gives the best accuracy and performance. If your data is already in a warehouse, start here.

For Parquet files that already live in S3, Amazon Athena can query the files in place through external tables without copying them.

### Sync

Humm syncs a copy of your SaaS, database, or file-based data into your warehouse via Airbyte, then queries that copy. Better performance and accuracy than live SaaS calls, and the data lives in your warehouse so you can join it with everything else. Available for: Absorb, Amplitude, Attio, Chargebee, ChurnZero, Customer.io, Delighted, Freshdesk, Gong, GuideCX, Help Scout, HubSpot, Intercom, Jira, Linear, Meta Ads, Mixpanel, Monday.com, PostHog, PostgreSQL, Productboard, S3, Salesforce, Statsig, Stripe, SurveyMonkey, Typeform, Zendesk, Zoom.

### SaaS (Live)

Humm queries the SaaS API directly in real time. Data is never stored by Humm. Slower for large queries, but useful if you don't want data copied anywhere.

### Which should I use?

1. **Connect your data warehouse** if you have one. It's the most accurate and fastest source.
2. **Use Sync** if you want SaaS data joined with warehouse data, or need better performance than live API calls.
3. **Use SaaS live** if you want real-time data and don't want Humm to store anything.

***

## How to Add an Integration

1. Click **Integrations** in the sidebar
2. Click **Browse Catalog**
3. Select the integration you want to connect
4. Enter your credentials and click **Save**
5. Click **Introspect Schema** to let Humm learn the data structure

Most integrations take just a few minutes to set up. Once connected, Humm automatically discovers your tables, fields, and relationships.

***

## Multiple Instances of the Same Integration

For supported integrations, you can connect multiple instances of the same connector. This is useful when:

* You have separate accounts for different regions (e.g., US and EU)
* You manage different business units separately
* You need to query data from sandbox and production environments

When you connect multiple instances, Humm automatically qualifies tool names with the instance label to distinguish them. For example, if you connect two Chargebee instances labeled "US" and "EU":

* `CHARGEBEE_US_LIST_CUSTOMERS` — List customers from the US instance
* `CHARGEBEE_EU_LIST_CUSTOMERS` — List customers from the EU instance

This prevents confusion and ensures queries use the correct data source.

***

## Available Integrations

### Data Warehouses

Connect your warehouse and Humm queries it directly — fastest and most accurate source type.

<CardGroup cols={2}>
  <Card title="Snowflake" icon="snowflake" href="/integrations/snowflake">
    Cloud data warehouse with private key or password auth.
  </Card>

  <Card title="BigQuery" icon="google" href="/integrations/bigquery">
    Google's data warehouse with service account auth. Supports Sheets-backed tables.
  </Card>

  <Card title="Amazon Athena" icon="aws" href="/integrations/athena">
    Query S3 data and Parquet external tables via Athena and AWS Glue Data Catalog.
  </Card>

  <Card title="Databricks" icon="database" href="/integrations/databricks">
    Unified analytics platform with SQL warehouse support.
  </Card>

  <Card title="PostgreSQL" icon="database" href="/integrations/postgresql">
    Connect directly to PostgreSQL databases.
  </Card>

  <Card title="MySQL" icon="database" href="/integrations/mysql">
    Connect directly to MySQL databases.
  </Card>
</CardGroup>

### Object Storage Sync

Sync file-based data from storage buckets into your warehouse.

<CardGroup cols={2}>
  <Card title="S3" icon="aws" href="/integrations/s3-sync">
    Sync CSV, JSONL, Parquet, or Avro files from an S3 bucket.
  </Card>
</CardGroup>

### Database Sync

Sync operational database tables into your warehouse when direct query access is not the right fit.

<CardGroup cols={2}>
  <Card title="PostgreSQL (Data Sync)" icon="database" href="/integrations/postgres-sync">
    Sync PostgreSQL tables with SSL and optional SSH tunneling.
  </Card>
</CardGroup>

### CRM & Sales

Query contacts, companies, deals, and customer relationships from your CRM.

<CardGroup cols={2}>
  <Card title="Salesforce" icon="salesforce" href="/integrations/salesforce">
    Leads, opportunities, accounts, and custom objects.
  </Card>

  <Card title="HubSpot" icon="hubspot" href="/integrations/hubspot">
    Contacts, deals, companies, and marketing data.
  </Card>

  <Card title="Attio" icon="address-book" href="/integrations/attio">
    Modern CRM with flexible data models.
  </Card>

  <Card title="Gong" icon="phone" href="/integrations/gong">
    Call recordings, transcripts, and conversation intelligence.
  </Card>
</CardGroup>

### Customer Success & Support

Pull in customer health, engagement, and support history.

<CardGroup cols={2}>
  <Card title="ChurnZero" icon="heart-pulse" href="/integrations/churnzero">
    Health scores, churn predictions, and engagement tracking.
  </Card>

  <Card title="Intercom" icon="comments" href="/integrations/intercom">
    Customer conversations and support interactions.
  </Card>

  <Card title="Zendesk" icon="headset" href="/integrations/zendesk">
    Support tickets, users, organizations, and comments.
  </Card>

  <Card title="Freshdesk" icon="headset" href="/integrations/freshdesk-sync">
    Sync tickets, contacts, companies, and support operations data.
  </Card>

  <Card title="Help Scout" icon="message-lines" href="/integrations/helpscout-sync">
    Sync conversations, inboxes, customers, and workflows.
  </Card>
</CardGroup>

### Product Analytics

See how customers actually use your product with usage data and behavioral analytics.

<CardGroup cols={2}>
  <Card title="Pendo" icon="chart-line" href="/integrations/pendo">
    Feature adoption, page views, and in-app guides.
  </Card>

  <Card title="Mixpanel" icon="chart-bar" href="/integrations/mixpanel">
    Event tracking, funnels, and user behavior.
  </Card>

  <Card title="PostHog" icon="flask" href="/integrations/posthog">
    Product analytics with HogQL query support.
  </Card>

  <Card title="Amplitude" icon="chart-mixed" href="/integrations/amplitude">
    Event segmentation, cohort analysis, and user behavior.
  </Card>

  <Card title="Statsig" icon="gauge" href="/integrations/statsig-sync">
    Sync experiments, feature flags, configs, and event metrics.
  </Card>
</CardGroup>

### Project Management

Track customer-related work, feature requests, and team knowledge.

<CardGroup cols={2}>
  <Card title="Jira" icon="jira" href="/integrations/jira">
    Issues, projects, and sprint data from Atlassian.
  </Card>

  <Card title="Linear" icon="list-check" href="/integrations/linear">
    Issues, projects, and team workflows.
  </Card>

  <Card title="Confluence" icon="book" href="/integrations/confluence">
    Search and read pages, spaces, and blog posts.
  </Card>

  <Card title="Monday.com" icon="table-columns" href="/integrations/monday-sync">
    Sync boards, items, updates, teams, and workspace data.
  </Card>

  <Card title="Productboard" icon="rectangle-list" href="/integrations/productboard-sync">
    Sync features, notes, objectives, releases, and product planning data.
  </Card>
</CardGroup>

### Billing & Subscriptions

Track revenue, subscriptions, and billing data.

<CardGroup cols={2}>
  <Card title="Chargebee" icon="credit-card" href="/integrations/chargebee">
    Subscriptions, invoices, transactions, and product catalog.
  </Card>

  <Card title="Stripe" icon="credit-card" href="/integrations/stripe-sync">
    Sync charges, invoices, subscriptions, payouts, and payment activity.
  </Card>
</CardGroup>

### Marketing & Advertising

Connect campaign, automation, and ad platform data.

<CardGroup cols={2}>
  <Card title="Customer.io" icon="paper-plane" href="/integrations/customerio-sync">
    Sync campaigns, campaign actions, and newsletters.
  </Card>

  <Card title="Meta Ads" icon="bullhorn" href="/integrations/meta-ads-sync">
    Sync campaigns, ad sets, ads, creatives, and performance insights.
  </Card>
</CardGroup>

### Surveys & Feedback

Bring in survey responses, forms, and customer sentiment data.

<CardGroup cols={2}>
  <Card title="Delighted" icon="face-smile" href="/integrations/delighted-sync">
    Sync survey responses, people, and unsubscribed contacts.
  </Card>

  <Card title="SurveyMonkey" icon="list-check" href="/integrations/surveymonkey-sync">
    Sync surveys, questions, collectors, and response data.
  </Card>

  <Card title="Typeform" icon="clipboard-question" href="/integrations/typeform-sync">
    Sync forms, responses, webhooks, and workspace metadata.
  </Card>
</CardGroup>

### Communication & Meetings

Analyze meeting, webinar, and collaboration activity.

<CardGroup cols={2}>
  <Card title="Zoom" icon="video" href="/integrations/zoom-sync">
    Sync meetings, webinars, registrants, polls, and participant reports.
  </Card>
</CardGroup>

### Custom Integrations

Don't see your tool listed? You can connect to almost any system with a REST API.

<CardGroup cols={1}>
  <Card title="Custom REST API" icon="code" href="/integrations/custom-rest-api">
    Connect to any REST API with flexible authentication options.
  </Card>
</CardGroup>

***

## What Data Does Humm Access?

When you connect an integration, Humm gets **read-only** access to your data. Humm can:

* Query and retrieve data to answer your questions
* Discover your schema (tables, fields, relationships)
* Pull sample data to understand your data structure

Humm **cannot** modify, delete, or write data to your connected systems.

***

## Need Help?

If you're having trouble connecting an integration or need a new integration added, reach out to your Humm account team at [hey@heyhumm.ai](mailto:hey@heyhumm.ai).