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

# Lists

> Collect and organise the people and companies surfaced by your signals, then take action through filters, integrations, and notifications.

A List is a dynamic collection of people or companies that match conditions you define — specific signals, audiences, or activity patterns. Lists capture the output of your signals and organise it into actionable groups.

Each list updates automatically as new signals come in, so you always see the most relevant data.

## Why use lists?

Lists help you move from insight to action:

* **Segment results** — group people or companies by shared behaviours or characteristics.
* **Prioritise outreach** — identify those showing the strongest buying intent.
* **Track changes over time** — watch how a segment evolves as new signals appear.
* **Automate workflows** — connect lists to webhooks, HeyReach, or Slack to act on new leads automatically.

## Create a list

<Steps>
  <Step title="Open the create dialog">
    Hover over **Lists** in the left sidebar and click the **+** button that appears.
  </Step>

  <Step title="Name your list">
    Enter a name and click **Create List**.
  </Step>

  <Step title="Define conditions">
    Choose audiences, add filters, or specify which signals to include.
  </Step>

  <Step title="Save your list">
    Click **Save** > **Save to this list** to apply your changes.
  </Step>
</Steps>

To keep the current list unchanged and create a new one with different filters, click **Save** > **+ Create new list**.

Clearcue starts populating your list immediately with people or companies that match your conditions.

## Personalise a list

### Edit the list name

Click the list name in the header to enter edit mode. Type a new name, then press **Enter** or click away to save. Press **Escape** to cancel.

### Add an emoji

Click the emoji next to the list name to open the picker. Search or browse categories to find the right one. The emoji appears in both the list header and the sidebar for quick identification.

## Switch between People and Companies

Each list can show people or companies. Use the **People / Companies** toggle next to the list name to switch views. The count next to each tab updates in real time based on your current filters.

## Filter within a list

Narrow down results inside a list without changing the saved list conditions.

### Filter by signal

Use the **Signals** filter row below the main filter bar to show only entries that triggered specific signals. You can select individual signals or specific data sources within a signal.

Toggle **Show without signals** to include entries that have no signal matches.

### Filter by audience and properties

Use the main filter bar to narrow results by audience, tags, AI classifications, or other properties. Add multiple filters to combine conditions.

<Tip>
  Filters inside a list view are separate from the saved list conditions. Adjust them freely to explore your data — the underlying list stays unchanged until you save.
</Tip>

### Reset filters

If you have unsaved filter changes, a **Reset** button appears in the filter bar. Click it to revert to the last saved state of the list.

## Export data

Click the **Export** button in the filter bar to download your current list view as a CSV file. The export respects your active filters, so you can export a specific subset of your list.

Learn more about [exporting data](/integrations/exporting).

## List settings

Click the **three-dot menu** (vertical dots icon) in the top-right corner of a list to open the actions menu.

| Action            | What it does                                                            |
| ----------------- | ----------------------------------------------------------------------- |
| **List settings** | Opens the settings page where you manage integrations and notifications |
| **Delete list**   | Removes the list permanently (with confirmation)                        |

### Integrations and notifications

Select **List settings** from the three-dot menu to open a dedicated page for managing how the list connects to external tools. The settings page has two tabs: **Integrations** and **Notifications**.

### Integrations tab

The Integrations tab lets you connect your list to external services that receive data when new leads appear.

#### Webhooks

Send list events to any HTTP endpoint. Use webhooks to connect Clearcue with your CRM, internal tools, or automation platforms.

<Steps>
  <Step title="Open list settings">
    Click the three-dot menu on your list and select **List settings**.
  </Step>

  <Step title="Click Configure (or Add)">
    On the **Webhooks** card, click **Configure** to create your first webhook, or **Add** to create additional ones.
  </Step>

  <Step title="Enter the webhook URL">
    Provide the HTTP endpoint that should receive events and confirm.
  </Step>
</Steps>

Once configured, each webhook shows its URL and has controls to:

* **Enable / disable** — toggle the switch to pause or resume event delivery without deleting the webhook.
* **Delete** — remove the webhook permanently.

Learn more in the [Webhooks guide](/integrations/webhooks).

#### HeyReach

Sync your list directly to a HeyReach list for LinkedIn outreach. When new leads appear in your Clearcue list, they are automatically pushed to HeyReach.

<Steps>
  <Step title="Open list settings">
    Click the three-dot menu on your list and select **List settings**.
  </Step>

  <Step title="Click Configure (or Add)">
    On the **HeyReach** card, click **Configure**. If HeyReach is not connected yet, the dialog walks you through connecting your account first.
  </Step>

  <Step title="Choose a HeyReach list">
    Select which HeyReach list should receive the synced leads and confirm.
  </Step>
</Steps>

Once configured, each sync shows the target HeyReach list name and has controls to:

* **Enable / disable** — toggle the switch to pause or resume syncing.
* **Delete** — remove the sync permanently.

Learn more in the [HeyReach integration guide](/integrations/heyreach).

### Notifications tab

The Notifications tab lets you receive alerts when new leads are added to the list.

#### Slack

Get Slack messages whenever new leads appear in your list. Each notification shows the channel it posts to and the delivery schedule.

<Steps>
  <Step title="Open list settings">
    Click the three-dot menu on your list and select **List settings**.
  </Step>

  <Step title="Switch to the Notifications tab">
    Click **Notifications** at the top of the settings page.
  </Step>

  <Step title="Connect Slack (if needed)">
    If Slack is not connected yet, click **Connect Slack** to authorize via OAuth.
  </Step>

  <Step title="Click Configure (or Add)">
    On the **Slack** card, click **Configure** to set up a notification, or **Add** to create additional ones.
  </Step>

  <Step title="Choose a channel and schedule">
    Select the Slack channel and delivery time, then confirm.
  </Step>
</Steps>

Each configured notification shows the channel name and delivery time. Click the trash icon to remove a notification.

Learn more in the [Slack integration guide](/integrations/slack).

## Delete a list

Select **Delete list** from the three-dot menu. A confirmation dialog appears showing the list name. Click **Delete** to confirm.

<Warning>
  Deleting a list is permanent and cannot be undone. The people and companies in the list are not affected — only the list itself is removed.
</Warning>

## Related

<CardGroup cols={3}>
  <Card title="Signals" icon="signal-bars" href="/signals">
    Understand the actions and behaviours that reveal intent.
  </Card>

  <Card title="HeyReach" icon="share-nodes" href="/integrations/heyreach">
    Sync lists to HeyReach for automated LinkedIn outreach.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/integrations/webhooks">
    Send events to external tools when new leads appear.
  </Card>
</CardGroup>