# geni crm fields (/cli/crm/fields)



Custom field definitions for people, companies, and cards. This group manages the definitions only. Field values are written through the entity's `custom` object on create and update. This is a pure verb group with no default action.

## list [#list]

```sh
geni crm fields list card --pipeline ppl_01HX
```

List an entity's custom field definitions. Card fields are per-pipeline, so `--pipeline` is required for them.

| Arg / Flag        | Notes                                   |
| ----------------- | --------------------------------------- |
| `<entityType>`    | `person`, `company`, or `card`.         |
| `--pipeline <id>` | Pipeline id (required for card fields). |
| `--json`          | Machine-readable output.                |

## create [#create]

```sh
geni crm fields create --json '{"entityType":"company","label":"ARR","fieldType":"number"}'
```

Create a custom field. `--json` is `{ entityType, label, fieldType, scopeId? (pipeline id, for card fields), options?, ... }`.

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

## update [#update]

```sh
geni crm fields update fld_01HX --json '{"label":"Annual recurring revenue","required":true}'
```

Update a custom field. `--json` is `{ label?, options?, required?, ... }`.

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

## reorder [#reorder]

```sh
geni crm fields reorder fld_01HX fld_01HY fld_01HZ
```

Reorder custom fields. Pass all field ids in the desired order.

| Arg        | Notes                               |
| ---------- | ----------------------------------- |
| `<ids...>` | All field ids in the desired order. |

## delete [#delete]

```sh
geni crm fields delete fld_01HX
```

Archive a custom field.

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