Stacksync Email Trigger

Email Trigger enables inbound email ingestion for workflows by exposing a dedicated, Stacksync-managed address. Each received email deterministically creates a workflow execution and provides the normalized email payload to downstream modules for processing.

1. Add the Email Trigger Module

1.1 Create a workflow and click on Create Trigger.

1.2 Add Receive Email from the Stacksync modules.

1.3 Connect the trigger to Input module to enable processing.

1.4 Save the workflow to activate the trigger.

Operational Behavior

• Each Email Trigger instance provisions a unique email address bound to this workflow.

• Multiple Email Trigger modules can be added to the same workflow, each receives a distinct email address.

• Activation requires a edge connection to input node.

• Disconnecting edge pauses ingestion.

• Deleting the module disables ingestion.

2. Get the Workflow Email Address

2.1 Open the module configuration panel.

2.2 Copy the Workflow Email Address displayed.

Example

[email protected]

Constraints

• Domain: @stacksync.email.

• Activation: immediate after connect and saved.

3. Configure a Custom Alias (Optional)

3.1 Enter a human-friendly alias in the alias field.

3.2 Confirm availability.

3.3 Save to apply changes.

Alias Format

{alias}@stacksync.email

Examples

• [email protected]

• [email protected]

• [email protected]

Alias Requirements

• Length greater then 3 characters.

• Characters: lowercase letters, numbers, ., -, _.

Alias Behavior

• Alias activation is immediate upon save.

• The previously configured alias is disabled immediately upon change.

• The system-generated workflow email address remains permanently active.

• When an alias is configured, both the workflow email address and the alias independently trigger the same workflow.

  

4. Email Payload Available to the Workflow

4.1 Email Fields

Field	Description	Example
from	Sender address	[email protected]
to	Recipient address(es)	[email protected]
subject	Subject line	New order — #4021
text	Plain-text body	Please process the order...
html	HTML body (if present)	<p>Please process the order...</p>
headers	Standard headers (message-id, reply-to, etc.)	—
attachments	Attachment list	See 4.2

4.2 Attachments (auto-ingested and stored securely)

Property	Description	Example
filename	Original file name	invoice.pdf
content_type	MIME type	application/pdf
file_id	Reference for downstream access	file_a1b2c3d4

5. Email Routing & Operations

5.1 Address Uniqueness & Isolation

• Each Email Trigger is assigned a unique, Stacksync-managed email address.

• Emails sent to that address are routed exclusively to the workflow where the trigger is configured.

5.2 Pause ingestion: disconnect the Email Trigger module.

5.3 Resume ingestion: reconnect and save.

5.4 Address rotation: update alias and notify senders.