> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/list-fields.md).

# List Easit Fields

List the connected Easit module's fields, and valid values for fields that only accept one of a fixed set (like status or category). Call this before Set Easit Item Field to pick a field's exact systemName and, for a field with values listed, the exact value id to send. List Easit Field Values distinguishes typed fields from an empty fixed-choice data source.

**Action identifier:** `list_fields`.

### Inputs

This action takes no input fields.

### Output

Paths are relative to this action's output. Select them from the builder's variable picker rather than typing them. A field that is null or empty was not returned by Easit; it is not proof that the value is empty in Easit.

| Path                      | Type             | Meaning                                                                                        |
| ------------------------- | ---------------- | ---------------------------------------------------------------------------------------------- |
| `module_id`               | integer          | Tenant-specific numeric module id, when available.                                             |
| `fields`                  | array of objects | Available fields and their fixed-choice values in the configured module.                       |
| `fields[].system_name`    | string           | Exact Easit field system name.                                                                 |
| `fields[].label`          | string           | Human-readable localized display label.                                                        |
| `fields[].values`         | array of objects | Fixed-choice ids and labels; empty for typed fields or data sources with no configured values. |
| `fields[].values[].id`    | string           | Data-source value id to pass to a field write action.                                          |
| `fields[].values[].label` | string           | Human-readable localized display label.                                                        |

### Declared errors

Instead of the output above, the action can return one of these objects. Check for them before using the output in a later step.

#### `EasitUnavailable`

Easit could not be reached, or refused the request.

| Path        | Type           | Meaning                                                        |
| ----------- | -------------- | -------------------------------------------------------------- |
| `reachable` | boolean        | False when Easit could not be reached or rejected the request. |
| `endpoint`  | string \| null | Easit API endpoint involved in the failed request, when known. |
| `error`     | string         | Safe error code or diagnostic without credentials.             |
| `hint`      | string \| null | Suggested connection or permission check, when available.      |

### Behavior and limits

Runtime discovery for a workflow or LLM step that needs to choose both a field and a valid value. Takes no arguments and uses the connection's configured module.

Returns `module_id` and `fields`, each with `system_name`, localized `label`, and fixed-choice `values` as id/label pairs. Use the exact system name and value id in [**Set Easit Item Field**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/set-item-field.md). An empty values list can also mean an empty data source; use [**List Easit Field Values**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/list-field-values.md) to distinguish that from a text/number field.

This action runs inside a workflow. During workflow authoring, open [**Set Easit Item Field**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/set-item-field.md)'s live field dropdown instead. Discovery walks each relevant data source and can require several requests. If the field is already known, prefer [**List Easit Field Values**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/list-field-values.md).

Returns declared `EasitUnavailable` on a failed read.

See [Troubleshooting](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/troubleshooting.md), or return to the [action catalog](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions.md).
