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

# Easit action reference

All 16 actions provided by the Easit GO Workflow Server. Choose an action by the result you need, then read its inputs, output paths and behavior.

### Read tickets

Fetch a ticket and its messages. GraphQL actions take the internal numeric item id, never the visible ticket number.

| Action                                                                                                                                                                                                     | Identifier                   | Purpose                                                                                                                                                                  |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Get Easit Item (GraphQL)](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/get-item-graphql.md)                   | `get_item_graphql`           | Fetch a single Easit GO item by internal id via the GraphQL API                                                                                                          |
| [Find Easit Item by Ticket Number](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/find-item-by-ticket-number.md) | `find_item_by_ticket_number` | Find an Easit item by the ticket number shown in Easit's UI (sequenceId) and return the item, including the internal id that the update, field and email actions require |
| [Get Easit Messages (GraphQL)](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/get-messages.md)                   | `get_messages`               | Read messages (email thread) on an Easit GO item via the GraphQL API                                                                                                     |

### Update tickets

Write field values. Fixed-choice fields take the data-source id, not the label shown in Easit.

| Action                                                                                                                                                                                         | Identifier            | Purpose                                                                 |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ----------------------------------------------------------------------- |
| [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)             | `set_item_field`      | Set a single field on an Easit item (field chosen from a live dropdown) |
| [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_item_status`     | Set an item's status (value chosen from a live dropdown)                |
| [Set Easit Category](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/set-item-category.md)            | `set_item_category`   | Set an item's category (value chosen from a live dropdown)              |
| [Set Easit Priority](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/set-item-priority.md)            | `set_item_priority`   | Set an item's priority (value chosen from a live dropdown)              |
| [Update Easit Item (GraphQL)](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/update-item-graphql.md) | `update_item_graphql` | Update an existing Easit GO item via the GraphQL API (updateItems)      |

### Email and ticket messages

Send email through the customer's Easit mail rule, or record a message on the ticket without sending anything.

| Action                                                                                                                                                                                                  | Identifier          | Purpose                                                                                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Send Easit Email](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/send-easit-email.md)                        | `send_easit_email`  | Write the connection's mapped email fields on an Easit item, then update the mapped trigger field to activate the customer's Easit mail rule. Requires the mail field mapping on the connection; the rule itself is configured in Easit                                                                               |
| [Record Easit Ticket Message (No Email)](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/respond-to-ticket.md) | `respond_to_ticket` | Record a message on an Easit GO ticket: resolves an approved requester-email field, creates a styled message, and tags it for loop protection. This does NOT send email - Easit has confirmed createMessages cannot deliver mail. Use Send Easit Email for outbound mail; use this for an agent-visible thread entry. |

### Discovery and diagnostics

Look up fields, valid values and modules at runtime, or check that Easit is reachable.

| Action                                                                                                                                                                                   | Identifier          | Purpose                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [List Easit Fields](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/list-fields.md)             | `list_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. |
| [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) | `list_field_values` | Check one Easit field's valid values by its systemName. Returns the field checked and, if it only accepts one of a fixed set (like status or category), every valid value as 'label (id)' text — use the id in Set Easit Item Field's value. A field with no fixed values accepts typed text or a number directly.                                                        |
| [List Easit Modules](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/list-modules.md)           | `list_modules`      | Discover the modules available in the connected Easit environment                                                                                                                                                                                                                                                                                                         |
| [Ping Easit GO](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/ping.md)                        | `ping`              | Check Integration API /ping reachability. This does not verify GraphQL access or the API token's permissions.                                                                                                                                                                                                                                                             |

### Legacy Integration API

Kept for existing Item View and Import Handler contracts. Use the GraphQL actions for new workflows.

| Action                                                                                                                                                                                               | Identifier    | Purpose                                                                                                                                      |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [Get Easit Items (Legacy Integration API)](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/get-item.md)     | `get_item`    | Read an existing Easit Integration API Item View by its identifier and optional idFilter. New workflows should use the GraphQL item actions. |
| [Update Easit Item (Legacy Import Handler)](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/update-item.md) | `update_item` | Create or update through an existing Easit Integration API Import Handler. Its OK result does not confirm that an item matched or changed.   |

### Before using an output

Every GraphQL action takes the internal numeric item id (`item_id`). The visible ticket number is a different number: resolve it first with [Find Easit Item by Ticket Number](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/find-item-by-ticket-number.md), or map the trigger's `item.internal_id`.

Write actions report `success`. A run can finish as **Done** in Automations even when `success` is false, so check it with a condition node when a later step depends on the write.

See [Workflow patterns](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/workflow-patterns.md), [Troubleshooting](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/troubleshooting.md), or the [integration overview](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations.md).
