Skip to content

Inbound Email Event Node

Events

Run a server workflow when an email arrives at its assigned address

events_inbound_emaildataStart node
Inputs0
Outputs7
Security exposure5/10
Packagedata

Ratings

Scores range from 0 to 10. Higher values mean more impact, exposure, or operational weight.

SecurityAttack surface and exposure impact.
5/10Medium
PrivacyPotential sensitivity of processed data.
4/10Medium
PerformanceRuntime or resource pressure.
8/10High
GovernancePolicy, audit, or compliance impact.
7/10High
ReliabilityOperational stability considerations.
7/10High
CostExternal or compute cost impact.
8/10High

Input Pins

0

No input pins.

Output Pins

7

Output

Execution
exec_out

Run when an email is received

Message

Struct
message

Reference to this email for Reply Platform Email

MailMessageRefMailMessageRef2 fields
sessionMailSessionrequired
app_idstringrequired
event_idstringrequired
delivery_idstringrequired

Internal inbound delivery ID. The mail provider's ID stays on InboundEmail.

Mail Session

Struct
session

App and Event reference for sending new mail from this automation address

MailSessionMailSession2 fields
app_idstringrequired
event_idstringrequired

Addresses

Struct
addresses

Sender, header recipients and SMTP envelope addresses

InboundEmailAddressesInboundEmailAddresses7 fields
senderanyOf (2)

Sender header, falling back to the first From address

variant 1InboundEmailAddressvariant
namestring | null
default null
emailstring | null
default null
variant 2nullvariant
fromArray<InboundEmailAddress>required
itemsInboundEmailAddressarray item
namestring | null
default null
emailstring | null
default null
toArray<InboundEmailAddress>required
itemsInboundEmailAddressarray item
namestring | null
default null
emailstring | null
default null
ccArray<InboundEmailAddress>required
itemsInboundEmailAddressarray item
namestring | null
default null
emailstring | null
default null
reply_toArray<InboundEmailAddress>required
itemsInboundEmailAddressarray item
namestring | null
default null
emailstring | null
default null
envelope_fromstringrequired

SMTP envelope sender

recipientstringrequired

The automation address that received the email

Content

Struct
content

Subject and body previews, plus temporary files with the complete bodies

InboundEmailContentInboundEmailContent7 fields
subjectstringrequired
textstringrequired
htmlstringrequired
text_truncatedbooleanrequired

Text is a preview. Read text_path for the complete plain text body

html_truncatedbooleanrequired

HTML is a preview. Read html_path for the complete HTML body

text_pathanyOf (2)
variant 1FlowPathvariant
pathstringrequired
store_refstringrequired
cache_store_refstring | null
variant 2nullvariant
html_pathanyOf (2)
variant 1FlowPathvariant
pathstringrequired
store_refstringrequired
cache_store_refstring | null
variant 2nullvariant

Attachments

Struct Array
attachments

Attachment filenames, content types, byte sizes and temporary files. Embedded is true for parts the HTML body shows through cid:<content_id>, such as signature logos, which are rarely real attachments. Copy files to app storage to keep them

InboundEmailAttachmentInboundEmailAttachment8 fields
filenamestring | null
default null
content_typestringrequired
sizeinteger:uint64required
format uint64min 0
pathFlowPathrequired
pathstringrequired
store_refstringrequired
cache_store_refstring | null
content_idstring | null

Content-ID without angle brackets, referenced from HTML as `cid:<content_id>`.

default null
dispositionstring | null

Lower-case Content-Disposition type: `inline` or `attachment`.

default null
charsetstring | null

Declared charset. Text files in any other charset than UTF-8 or US-ASCII are stored as UTF-8.

default null
embeddedboolean

Image or other part shown inside the HTML body through its Content-ID, such as a signature logo.

default false

Delivery

Struct
delivery

Machine-generated flag, file expiry, raw EML file, headers and authentication verdicts

InboundEmailDeliveryInboundEmailDelivery9 fields
automatedbooleanrequired

Bounce, auto-reply, mailing list or other machine-generated mail. Platform replies to it are refused to prevent mail loops

expires_atstring | null

When the raw, body and attachment files are deleted

format date-time
raw_pathFlowPathrequired

Complete MIME message as a temporary EML file

pathstringrequired
store_refstringrequired
cache_store_refstring | null
omitted_attachmentsinteger:uint32required

Attachments beyond the limit of 100 that are only contained in the raw EML file

format uint32min 0
received_atstring | null
format date-time
message_idstring | null
provider_delivery_idstringrequired

The mail provider's delivery ID

headersArray<InboundEmailHeader>required
itemsInboundEmailHeaderarray item
namestringrequired
valuestringrequired
authenticationanyOf (2)
variant 1InboundEmailAuthenticationvariant
providerstring | null
default null
spamanyOf (2)
default null
variant 1InboundEmailVerdictvariant
variant 2nullvariant
virusanyOf (2)
default null
variant 1InboundEmailVerdictvariant
variant 2nullvariant
spfanyOf (2)
default null
variant 1InboundEmailVerdictvariant
variant 2nullvariant
dkimanyOf (2)
default null
variant 1InboundEmailVerdictvariant
variant 2nullvariant
+2 more fields
variant 2nullvariant

Node Info

Internal name
events_inbound_email
Category
Events
Version
4