---
name: hunter-company-lists
description: Saves companies and organizes them into Hunter company lists — save a company, add/remove companies to lists, create and manage lists and folders, and bulk copy/move/delete companies. Use when the user wants to save companies from a search, build a target-account list, or organize companies into lists and folders.
---

# Company Lists

Save companies and organize them into lists and folders — the account-level counterpart to `hunter-lead-lists`.

## Examples

- `"Save stripe.com to my prospects"`
- `"Add these Discover results to a new list"`
- `"Move the EU accounts into a Europe folder"`
- `"Copy these companies to my Q3 list"`

## Workflow

### Step 1: Save companies

- Save a single company → `Save-Company` (from a domain or a Discover / enrichment result).
- Companies typically come from `hunter-discover` (`Find-Companies`) or `hunter-company-enrichment`.

### Step 2: Create or pick a list

- New list → `Create-Company-List` with a descriptive name.
- Existing → `List-Company-Lists` to browse, then use its ID.

### Step 3: Populate

- Add saved companies → `Add-Company-To-List`.
- Remove → `Remove-Company-From-List`.
- Move / copy in bulk across lists → `Bulk-Move-Companies` / `Bulk-Copy-Companies`.
- Note: list membership and bulk **move** require static lists; bulk **copy** requires only the *destination* static (its source may be dynamic). `Bulk-Delete-Companies` accepts any team-owned list, including dynamic ones. Dynamic (auto-filter) lists can't be the target of add/move — pick a static target when the user chooses from `List-Company-Lists`.

### Step 4: Organize

- **Favorite / unfavorite** → `Favorite-Company-List` / `Unfavorite-Company-List`.
- **Folders** → `List-Company-List-Folders`, `Create-Company-List-Folder` (requires both a `name` **and** a `color` — ask the user or pick one; unlike leads-list folders, Hunter won't default it), `Update-Company-List-Folder` (renames/recolors a folder). To **file a list into a folder**, call `Update-Company-List` with the target `company_list_folder_id` — the folder tool only edits folder metadata, not membership.
- **Rename** → `Update-Company-List`; **read** → `Get-Company-List`.

### Step 5: Present summary

```
# Company List: Target Accounts

**Companies:** [count]

## Next Actions
1. Find contacts at these companies (`hunter-domain-search`)
2. Save decision-makers as leads (`hunter-manage-leads` / `hunter-lead-lists`)
3. Run a full prospecting pass on the list (`hunter-prospecting`)
```

## Guardrails

Confirm before destructive, irreversible, or bulk actions — state the operation, the count, and the target, then wait for a "yes" (adding a single company to a list is additive and needs no gate):

- `Delete-Company-List` — deleting a static list can also delete companies left orphaned by it (and any dependent dynamic lists): "This deletes the '[name]' list; companies only in this list may be removed too. Confirm?"
- `Bulk-Delete-Companies` — "This permanently deletes [N] companies. Confirm?"
- `Bulk-Move-Companies` — echo how many companies and the destination.
- `Bulk-Copy-Companies` — the tool is confirmation-gated: the first call reports the affected count without copying, so echo that count and destination, then re-run confirmed.
- `Delete-Company-List-Folder` — clarify what happens to the lists inside, and confirm.

## Credit Cost

Free — saving companies and managing lists and folders does not consume credits.

## Important Notes

- Company lists organize companies (accounts); use `hunter-lead-lists` for contacts.
- Bulk copy/move act on many companies at once — confirm the count before running.