> 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/get-messages.md).

# Get Easit Messages (GraphQL)

Read messages (email thread) on an Easit GO item via the GraphQL API.

**Action identifier:** `get_messages`.

### Inputs

| Field     | Type    | Required/default | Meaning                                       |
| --------- | ------- | ---------------- | --------------------------------------------- |
| `item_id` | integer | Required         | Internal Easit item id whose messages to read |
| `limit`   | integer | `50`             | Max number of messages to return              |
| `offset`  | integer | `0`              | Pagination offset                             |

Example input:

```json
{
  "item_id": 8708,
  "limit": 50,
  "offset": 0
}
```

### 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                                                              |
| --------------------------------------- | ---------------- | -------------------------------------------------------------------- |
| `messages`                              | array of objects | Messages in the requested page of the item thread.                   |
| `messages[].id`                         | integer          | Internal Easit message id.                                           |
| `messages[].from_address`               | string \| null   | Sender address returned by Easit.                                    |
| `messages[].to`                         | array of strings | Recipient addresses recorded on the message.                         |
| `messages[].subject`                    | string \| null   | Message subject, when available.                                     |
| `messages[].body_plain`                 | string \| null   | Plain-text message body, when available.                             |
| `messages[].state`                      | string \| null   | Message state returned by Easit.                                     |
| `messages[].tags`                       | array of strings | Tags attached to the item or message.                                |
| `messages[].notification`               | boolean \| null  | Whether Easit marks the message as a notification.                   |
| `messages[].sent_or_received`           | string \| null   | Easit sent/received timestamp, when available.                       |
| `messages[].has_been_read`              | boolean \| null  | Whether Easit marks the message as read.                             |
| `messages[].not_sent_reason`            | string \| null   | Easit-provided reason the message was not sent, when available.      |
| `messages[].message_setting_identifier` | string \| null   | Tenant-specific message setting identifier.                          |
| `total`                                 | integer          | Number of messages returned in this page, not the full thread count. |

### Behavior and limits

Reads an item's message thread. Supply internal numeric `item_id`; optional `limit` defaults to 50 and `offset` to 0.

Returns `messages` with ids, sender/recipient information, subject, plain body, state, tags, and available Easit delivery/read metadata. `total` is the number returned in this page, not the total thread size. Increase `offset` to read another page.

Requires message read access. Transport and GraphQL failures propagate as HTTP errors. This action neither sends mail nor polls a mailbox.

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