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

# Creating a buyer list

> A buyer list defines the set of accounts you want to work with in Starbridge.

A **buyer list** is a collection of SLED entities — cities, counties, school districts, state agencies, or other public sector accounts — that represents the accounts you care about for a given use case. It's the basic unit of analysis in Starbridge: everything you do (scoring, enrichment, signals, territories) operates on a buyer list.

<Info>
  Not sure where to start? Most teams begin with a broad list — the most encompassing set of buyers they could plausibly sell into — and narrow from there.
</Info>

## How can a buyer list be used?

<CardGroup cols={3}>
  <Card title="Score your accounts" icon="chart-bar">
    Define the set of accounts you want to score and prioritize.
  </Card>

  <Card title="Define your TAM" icon="map">
    Represent your entire total addressable market.
  </Card>

  <Card title="Run an expansion play" icon="compass">
    Scope all accounts in a new geography or segment you want to move into.
  </Card>
</CardGroup>

## How to define a buyer list

There are four ways to define a buyer list in Starbridge.

<Tabs>
  <Tab title="Create in Starbridge">
    Build a list using Starbridge's built-in SLED data — either by applying filters (a **dynamic list**) or by selecting specific buyers manually (a **static list**).

    Starbridge includes out-of-the-box attributes you can use to slice your potential TAM into actionable lists, for example:

    * All cities and counties with a minimum population of 2,000
    * State agencies with minimum funding of \$1M
    * School districts above a minimum percentage of students eligible for free or reduced lunch
  </Tab>

  <Tab title="Import from CSV">
    Upload a static list of accounts as a CSV file. This is a good option if you already have a defined list of target accounts outside of Starbridge.

    <Warning>
      CSV-imported lists are static — they won't update over time. If you want your list to stay in sync with changes in your data, consider syncing from your CRM instead.
    </Warning>
  </Tab>

  <Tab title="Sync from Salesforce or HubSpot">
    Connect a Salesforce list or HubSpot segment to Starbridge and keep it up to date automatically. This is useful for plays that are grounded in your CRM data, for example:

    * All recently closed-lost accounts
    * Accounts with fewer than two ICP contacts (sync to Starbridge and enrich to fill the gap)

    See [CRM-Synced Buyer Lists](/integrations/crm-synced-buyer-lists) for setup guidance.
  </Tab>

  <Tab title="From an existing Bridge">
    Signals Bridges can often serve as a **filter** that narrows down your TAM to the buyers showing a specific pain point or signal. You can save that narrowed set as its own static buyer list and reuse it for further enrichment or outbound.

    <Steps>
      <Step title="Open the Bridge's actions menu">
        From the Bridge, open the three-dots menu and select **Create buyer list from bridge buyers**.

        <Frame>
          <img src="https://mintcdn.com/starbridge/35Bel3hyEg2J9NrK/images/Screenshot-2026-08-12-at-10.35.32-AM.png?fit=max&auto=format&n=35Bel3hyEg2J9NrK&q=85&s=cbb6d90fe77a45f0d0dedbfb5e7dfae8" alt="Screenshot 2026 08 12 At 10 35 32 AM" width="3412" height="1952" data-path="images/Screenshot-2026-08-12-at-10.35.32-AM.png" />
        </Frame>
      </Step>

      <Step title="Choose which buyers to include">
        <Tabs>
          <Tab title="All buyers in bridge">
            Every buyer represented in the Bridge's signals, regardless of the filters you currently have applied.

            <Frame>
              <img src="https://mintcdn.com/starbridge/35Bel3hyEg2J9NrK/images/Screenshot-2026-08-12-at-10.36.46-AM.png?fit=max&auto=format&n=35Bel3hyEg2J9NrK&q=85&s=f4c141b6a2a8b07762f1226987e563c2" alt="Screenshot 2026 08 12 At 10 36 46 AM" width="1698" height="1036" data-path="images/Screenshot-2026-08-12-at-10.36.46-AM.png" />
            </Frame>
          </Tab>

          <Tab title="All visible buyers in bridge">
            Only the buyers in signals that satisfy your current filters. Use this when you've narrowed the Bridge down to a specific segment — for example, rows above a certain match score.

            <Frame>
              <img src="https://mintcdn.com/starbridge/35Bel3hyEg2J9NrK/images/Screenshot-2026-08-12-at-10.36.46-AM-1.png?fit=max&auto=format&n=35Bel3hyEg2J9NrK&q=85&s=4363caf0d44e3704a3b52a5573eb3f12" alt="Screenshot 2026 08 12 At 10 36 46 AM 1" width="1698" height="1036" data-path="images/Screenshot-2026-08-12-at-10.36.46-AM-1.png" />
            </Frame>
          </Tab>
        </Tabs>
      </Step>

      <Step title="Name and save the list">
        The create buyer list flow opens with the relevant buyers already selected as a static list. Review the selection, name the list, and save.
      </Step>
    </Steps>

    <Note>
      A Bridge is itself is a search scoped to a set of buyers. This creates a list from the buyers **specifically present in the Bridge as rows**. The resulting list is **static**; it won't update as the Bridge picks up new rows.
    </Note>

    <Tip>
      This is a useful way to control credit spend before contact enrichment. Narrow a Bridge to your best-fit accounts, save those buyers as a list, then point a [Contacts Bridge](/builders/contacts-bridge) at it rather than at your full TAM.
    </Tip>
  </Tab>
</Tabs>

## Creating a buyer list

<Steps>
  <Step title="Create a new buyer list">
    Navigate to the **Buyers** tab and click **Create list**:

    <Frame>
      <img src="https://mintcdn.com/starbridge/A9tCM5ILLGIfxpSP/images/Screenshot-2026-04-17-at-1.45.44-PM.png?fit=max&auto=format&n=A9tCM5ILLGIfxpSP&q=85&s=973c1a35ca5bcc4985d229719e785ec3" alt="Screenshot 2026 04 17 At 1 45 44 PM" width="2268" height="1315" data-path="images/Screenshot-2026-04-17-at-1.45.44-PM.png" />
    </Frame>
  </Step>

  <Step title="Choose the buyer list type">
    <Tabs>
      <Tab title="Define a list">
        Use this when you want to define a list of buyers using Starbridge data, like:

        * Universities above 5,000 enrollment
        * Cities with budgets above \$10M
        * A specific set of buyers. For example, four specific universities: Texas A\&M, UMD, Texas Tech, and Caltech.

        <Tip>
          For your first buyer list, start broad: the most encompassing list of buyers you could plausibly sell into.
        </Tip>

        Select the type of buyer you want to appear in your list. This will pre-filter the results, which you can edit before saving your list.

        <Frame>
          <img src="https://mintcdn.com/starbridge/rNQFTplk-CxcPFGd/images/image-56.png?fit=max&auto=format&n=rNQFTplk-CxcPFGd&q=85&s=a9f8e4f50c40b41cec7c09fecf42dc61" alt="Image" width="2268" height="1315" data-path="images/image-56.png" />
        </Frame>

        Define your list in terms of filters (dynamic list) or by selecting a specific set of buyers (static list). Use the left menu to select more specific filters.

        <Frame>
          <img src="https://mintcdn.com/starbridge/rNQFTplk-CxcPFGd/images/image-57.png?fit=max&auto=format&n=rNQFTplk-CxcPFGd&q=85&s=5cf164c86eea6296013bd39a47601c9d" alt="Image" width="2268" height="1315" data-path="images/image-57.png" />
        </Frame>
      </Tab>

      <Tab title="Import from CSV">
        Use this when you have a static list of accounts that you want to import to Starbridge. This is a **static** list. If you want this buyer list to change over time, consider instead **syncing** a list of accounts from Salesforce or HubSpot.

        Download a template with the CSV format Starbridge needs to parse your uploaded accounts.

        <Frame>
          <img src="https://mintcdn.com/starbridge/ZGPvWytbCD0spbBC/images/Screenshot-2026-06-05-at-6.20.34-PM.png?fit=max&auto=format&n=ZGPvWytbCD0spbBC&q=85&s=991b6cf400ba3ad47970490b8e951c03" alt="Screenshot 2026 06 05 At 6 20 34 PM" width="3420" height="1958" data-path="images/Screenshot-2026-06-05-at-6.20.34-PM.png" />
        </Frame>

        The minimum requirements for uploading a custom list via a CSV file is the **account name** and **state**. However, additional datapoints like unique identifiers, websites, and zip codes are valuable and will make the list creation process faster. Starbridge will match your uploaded accounts to our buyers, ensuring a robust match with your list.

        Once you have uploaded your accounts, Starbridge will quickly scan the data to ensure there is no missing or incomplete data. If any such gaps are identified, you will be able to exclude those rows from matching or manually make any edits (like adding a missing state).

        <Frame>
          <img src="https://mintcdn.com/starbridge/9S5AIA8SddizhdQX/images/Screenshot-2026-06-09-at-5.36.38-PM.png?fit=max&auto=format&n=9S5AIA8SddizhdQX&q=85&s=78b4c74d861f204bb96c674f4f0e3da5" alt="Screenshot 2026 06 09 At 5 36 38 PM" width="3174" height="1752" data-path="images/Screenshot-2026-06-09-at-5.36.38-PM.png" />
        </Frame>

        Starbridge will return the corresponding buyer matched to every row of data in your uploaded file. You are able to review and download this result and make manual changes as you see fit. We recommend reviewing the unmatched accounts, likely not found due to incomplete or incorrect information, and create your customer list!

        <Frame>
          <img src="https://mintcdn.com/starbridge/9S5AIA8SddizhdQX/images/Screenshot-2026-06-09-at-5.40.23-PM.png?fit=max&auto=format&n=9S5AIA8SddizhdQX&q=85&s=1fa3b2c221f63171c904c28db3dfd096" alt="Screenshot 2026 06 09 At 5 40 23 PM" width="700" height="580" data-path="images/Screenshot-2026-06-09-at-5.40.23-PM.png" />
        </Frame>

        <Frame>
          <img src="https://mintcdn.com/starbridge/9S5AIA8SddizhdQX/images/Screenshot-2026-06-09-at-5.40.55-PM.png?fit=max&auto=format&n=9S5AIA8SddizhdQX&q=85&s=4b8039f3868e4a7ba379badf6b9c8c9b" alt="Screenshot 2026 06 09 At 5 40 55 PM" width="1106" height="682" data-path="images/Screenshot-2026-06-09-at-5.40.55-PM.png" />
        </Frame>
      </Tab>

      <Tab title="Sync from Salesforce or HubSpot">
        Use this when you want to sync a list of accounts from Salesforce or HubSpot, to keep it up to date with your Salesforce or HubSpot over time.

        See [CRM-Synced Buyer Lists](/integrations/crm-synced-buyer-lists) for more guidance.
      </Tab>
    </Tabs>
  </Step>
</Steps>

## Related articles

<CardGroup cols={3}>
  <Card title="CRM-synced Buyer Lists" icon="diagram-project" href="/integrations/crm-synced-buyer-lists">
    Learn about creating custom lists by syncing with your CRM, so that when your territories change, Starbridge dynamically updates.
  </Card>

  <Card title="Building Buyer Bridges" icon="layer-group" href="/builders/account-scoring-buyer-bridge">
    Discover use cases for building buyer Bridges, such as Account Scoring and custom Account Enrichment.
  </Card>

  <Card title="Buyer Attributes and Data" icon="globe" href="/data/buyer-attributes">
    Explore all the out-of-the-box attributes and datapoints Starbridge offers and keeps up to date for public sector accounts.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.