# Create Segments

**Setting Up HubSpot Segments for Boomerang**

This guide walks you through creating HubSpot Segments (Active Lists) so Boomerang can build and maintain your relationship graphs. Boomerang can track any cohort of contacts that's meaningful to your team.

> **Note:** If a contact appears across multiple segments, Boomerang will automatically prioritize the category most relevant to that contact.

***

**Creating a List in HubSpot**

1. In your HubSpot account, navigate to **CRM > Segments**
2. In the upper right, click **Create Segment**
3. In the left panel, select **Contact**
4. In the right panel, enter the list details — name your list starting with **"Boomerang - "** (e.g. "Boomerang - Customers") and make sure to select **Active List** so Boomerang can continuously sync updated contact data
5. In the upper right, click **Next**
6. In the left panel, set your filter criteria for the contacts you want to segment
7. In the upper right, click **Save list**

The list will begin processing once valid criteria are set. When complete, the total record count will appear under the list name in the upper left.

***

**Required Columns**

Before sharing your Segment with Boomerang, make sure the following columns are added to the list view:

| Column               | Description                             |
| -------------------- | --------------------------------------- |
| Contact ID           | Unique HubSpot contact identifier       |
| First Name           | Contact's first name                    |
| Last Name            | Contact's last name                     |
| Email                | Contact's email address                 |
| Title                | Job title                               |
| Account Name         | Associated company name                 |
| LinkedIn URL         | Contact's LinkedIn profile URL          |
| Account LinkedIn URL | Company LinkedIn page URL               |
| Account Domain       | Company website domain                  |
| Account ID           | Unique HubSpot account identifier       |
| Account Owner        | Name of the account owner               |
| Account Owner Email  | Email address of the account owner      |
| Account Owner ID     | Unique Hubspot account owner identifier |

***


---

# 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/create-segments.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.
