# geni crm lists (/cli/crm/lists)



Lead lists are purposed collections of people or companies. With no verb, `geni crm lists` lists them; the verb subcommands get one, create, update, delete, and add or remove members.

## list (default) [#list-default]

```sh
geni crm lists --type company
```

List the lead lists. Filter to one kind with `--type`.

| Flag            | Notes                             |
| --------------- | --------------------------------- |
| `--type <type>` | Only `person` or `company` lists. |
| `--json`        | Machine-readable output.          |

## get [#get]

```sh
geni crm lists get lst_01HX
```

Print one list's record.

| Arg    | Notes    |
| ------ | -------- |
| `<id>` | List id. |

## create [#create]

```sh
geni crm lists create --json '{"name":"Q3 target ICP","type":"company","purpose":"Series B fintech in the US"}'
```

Create a list. `--json` is `{ name, type: person|company, purpose? }`.

| Flag            | Notes                           |
| --------------- | ------------------------------- |
| `--json <body>` | Required. JSON list definition. |

## update [#update]

```sh
geni crm lists update lst_01HX --json '{"name":"Q4 target ICP"}'
```

Update a list. `--json` is `{ name?, purpose? }`.

| Arg / Flag      | Notes                            |
| --------------- | -------------------------------- |
| `<id>`          | List id.                         |
| `--json <body>` | Required. JSON fields to change. |

## delete [#delete]

```sh
geni crm lists delete lst_01HX lst_01HY
```

Delete one or more lists by id.

| Arg        | Notes               |
| ---------- | ------------------- |
| `<ids...>` | List ids to delete. |

## add [#add]

```sh
geni crm lists add lst_01HX per_01HX per_01HY
```

Add people or companies to a list.

| Arg              | Notes                         |
| ---------------- | ----------------------------- |
| `<listId>`       | List id.                      |
| `<entityIds...>` | Person or company ids to add. |

## remove [#remove]

```sh
geni crm lists remove lst_01HX per_01HX
```

Remove one member from a list.

| Arg          | Notes                           |
| ------------ | ------------------------------- |
| `<listId>`   | List id.                        |
| `<entityId>` | Person or company id to remove. |
