Triggering a process with email
In addition to the manual, scheduled, and API triggers, the Unattended
Processes also support triggering runs with emails. You can find the process
email trigger configuration using the
Configure Process button on the process
details page. The email configuration is under the
Schedules & Triggers tab.
Once you enable the trigger, you will be given a unique email address that is the
process's inbox. Sending emails to this address will create work items on
the processes input queue.
When enabled, Control Room will parse the email and extract email details to individual work item payload attributes and attachments. For backwards compatibility, this option can be disabled, and the Control Room will not parse the email but forwards the raw MIME message as a work item payload.
This option controls whether Control Room should trigger the process run for newly received emails or not. If the option is disabled, Control Room will not start runs for received emails, and the resulting work items will remain in the input queue.
Work item formats
Parsed email payload
The example below outlines the format for successfully received emails when the Parse email option is enabled.
Payload format for failed email receives
The example below outlines the format for work items resulting from email handling errors.
Unparsed raw payload format (deprecated)
The example below outlines the format for successfully received emails when the Parse email option is disabled. Note that this is a legacy format that has been deprecated. Support for this format will be disabled in the future.
The total size of the received email is limited to 40MB. This is the size of the email with all headers, content, and attachments. There are no separate limitations on e.g., individual attachment size.
If the received email size is over the limit the system won't
process the email at all and the email will be completely ignored and won't
e.g. create the work item with the