# HubSpot Integration Setup

## HubSpot Input Setup

Use this setup flow to prepare HubSpot data for Boomerang.

Boomerang uses HubSpot lists and CRM records to sync contacts, match companies, and build relationship graphs for your team.

### Before you begin

Make sure you have:

*  A dedicated integration user with the required permissions
* **Super Connector Admin** access in Boomerang
* A clear list strategy for the contact groups you want Boomerang to track

***

### Setup flow

Complete these steps in order:

1. [Create Active Lists](/integrations/hubspot-integration-setup/create-segments.md) in HubSpot and include the required contact and company fields.
2. [Connect Hubspot with Boomerang](/integrations/hubspot-integration-setup/connect-hubspot-with-boomerang.md) using your integration user.
3. [Add Hubspot Lists in Boomerang](/integrations/hubspot-integration-setup/add-hubspot-segments-in-boomerang.md) so Boomerang can ingest and use the data.

***

### What this setup enables

Once setup is complete, Boomerang can:

* Sync selected HubSpot contacts into relationship categories
* Match contacts to companies using HubSpot company data
* Use those records to build more accurate relationship graphs
* Keep data current as your Active Lists update over time

***

### Recommended setup order

Start with a small, high-value contact segment first.

Good examples include:

* Current customers
* Open pipeline contacts
* Target accounts
* Strategic partners

This makes it easier to validate list quality before scaling to more categories.

***

### Troubleshooting

* If no lists appear in Boomerang, confirm the lists are **Active Lists** and include **Boomerang** in the list name.
* If the HubSpot connection fails, verify the integration user has the required permissions.
* If contact counts look wrong, review the list filters and required fields before re-importing.

***

### Next steps

After HubSpot input setup is complete, review your imported categories and enable **Warm Relationship** where needed so Boomerang can use the data in relationship mapping.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.getboomerang.ai/integrations/hubspot-integration-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.