For the complete documentation index, see llms.txt. This page is also available as Markdown.

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:

{
  "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, or return to the action catalog.

Was this helpful?