> 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/set-item-field.md).

# Set Easit Item Field

Set a single field on an Easit item (field chosen from a live dropdown).

**Action identifier:** `set_item_field`.

### Inputs

| Field     | Type    | Required/default | Meaning                                                                                                                                                                      |
| --------- | ------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `item_id` | integer | Required         | Internal Easit item id                                                                                                                                                       |
| `field`   | string  | Required         | Easit field systemName (populated as a dropdown from the connection)                                                                                                         |
| `value`   | string  | Required         | Typed text/number or a data-source id from the selected field's value dropdown. For runtime-selected fields, discover ids with List Easit Fields or List Easit Field Values. |

Example input:

```json
{
  "field": "sys_subject",
  "item_id": 8708,
  "value": "Follow-up needed"
}
```

### 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                                                                           |
| ------------- | --------------- | --------------------------------------------------------------------------------- |
| `success`     | boolean         | Whether the requested operation completed successfully.                           |
| `item_id`     | integer         | Internal numeric Easit Item.id used by GraphQL actions.                           |
| `field`       | string          | Exact Easit field system name.                                                    |
| `sequence_id` | integer \| null | Visible ticket number (Item.sequenceId), when available; not the GraphQL item id. |
| `error`       | string \| null  | Failure details when the operation did not succeed; otherwise null.               |

### Behavior and limits

Updates one field on an item. Supply the internal numeric `item_id`, exact field system name in `field`, and string `value`.

Choose a field from the live list. Fixed-choice fields offer their data-source ids as a dependent value dropdown; text/number fields retain typed input. For example, `{"item_id": 8708, "field": "sys_subject", "value": "Follow-up needed"}`.

If the **Value** list stays empty after you pick a fixed-choice field, use [**Set Easit Status**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/set-item-status.md), [**Set Easit Category**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/set-item-category.md) or [**Set Easit Priority**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/set-item-priority.md) for those fields, or look up the id with [**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) and type it in.

For fields chosen at runtime, call [**List Easit Fields**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/list-fields.md) or [**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) first. Fixed-choice writes require ids, not labels. Numeric strings are converted for Easit; leading-zero text such as postal codes is preserved.

Returns `success`, `item_id`, `field`, best-effort `sequence_id`, and an optional `error`. No-op writes are read back before reporting failure.

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).
