Get Easit Messages (GraphQL)
Read messages (email thread) on an Easit GO item via the GraphQL API.
Action identifier: get_messages.
Inputs
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.
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?

