# geni crm people (/cli/crm/people)



People in the workspace's lead database. With no verb, `geni crm people` searches; the verb subcommands fetch one record and create, update, or delete. Creates and updates take a JSON array so you can batch many records in one call.

## search (default) [#search-default]

```sh
geni crm people "head of growth" --limit 50
```

Free-text search across name, title, and company. Omit the query to browse.

| Arg / Flag       | Notes                                            |
| ---------------- | ------------------------------------------------ |
| `[query]`        | Free-text search. Omit to browse.                |
| `--list <id>`    | Only people in this list.                        |
| `--company <id>` | Only people at this company.                     |
| `--limit <n>`    | Max results (1 to 100, default 25).              |
| `--json`         | Machine-readable output, including `nextCursor`. |

## get [#get]

```sh
geni crm people get per_01HX --field person.currentTitle
```

Print one person's full record. `--field <path>` extracts a single dotted-path value instead of the whole object.

| Arg / Flag       | Notes                                                     |
| ---------------- | --------------------------------------------------------- |
| `<id>`           | Person id.                                                |
| `--field <path>` | Print one dotted-path value (e.g. `person.currentTitle`). |

## create [#create]

```sh
geni crm people create --json '[{"fullName":"Ada Lovelace","companyName":"Acme","email":"ada@acme.com","title":"CTO"}]'
```

Find-or-create people, deduped org-wide. `--json` is an array of person objects; each needs `fullName`, plus optional `companyName` / `companyDomain`, `email`, `linkedinUrl`, `title`, and more.

| Flag             | Notes                                     |
| ---------------- | ----------------------------------------- |
| `--json <array>` | Required. JSON array of people to create. |

## update [#update]

```sh
geni crm people update --json '[{"id":"per_01HX","title":"VP Engineering"}]'
```

Update people by id. `--json` is an array of `{ id, ...fields }` objects.

| Flag             | Notes                                                |
| ---------------- | ---------------------------------------------------- |
| `--json <array>` | Required. JSON array of `{ id, ...fields }` updates. |

## delete [#delete]

```sh
geni crm people delete per_01HX per_01HY
```

Delete one or more people by id.

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