Email Trigger

We鈥檙e updating the term Pushbot to Workflow throughout Catalytic.聽Learn more

馃暀 3 minute read

Starts a Workflow instance when an email is delivered to a dedicated email address. Attributes of each email, including attachments, subject, sender, and more, are available as fields in each instance started.

The subject line of the message sent to the Email trigger will be used as the name of the triggered instance.

Use Case

Like Web form triggers, this trigger lets non-Catalytic users initiate a Workflow instance with an email. Another common use is to parse files, since files can be passed to Catalytic as an attachment through sent emails.

How to configure this trigger

You can add new triggers or configure any existing triggers on a Workflow鈥檚 edit screen. Triggers are configured for each Workflow.

Each email trigger is set up with a unique email address with the format {your-custom-address}@{your Catalytic team}, such as Change the address at any time from the triggers page of your Workflow.

Fields for this trigger

  • Email Address

    • Enter the email address name for the trigger.

What will this output?

Every incoming email starts an instance of a Workflow. Attributes of each email, including attachments, subject, or sender are available as fields within the Workflow.

Output fields for this trigger

  • autorespond

    • True or false for whether Catalytic responded to the sender with an automated email indicating that a new run was initiated.
  • bodytext

    • Body of the email in plain text.
  • destinationEmails

    • Comma separated string of all addresses where emails were sent. This will include the dedicated trigger address.
  • cc

    • Comma separated string of any addresses that were CC鈥檈d on the email
  • from

    • Combination of the two fields fullName and fromEmail in the format {{fullname}} <{{fromemail}}>
  • fromemail

    • Email address of sender
  • fullname

    • Full name of sender
  • html

    • Body of the email in HTML
  • mailboxuser

    • Portion of the {{fromemail}} before the @ symbol
  • senttimestamp

    • Time when the email was sent in 2019-02-27T22:58:21.145Z format.
  • subject

    • Subject line of the email
  • to

    • Array of all addresses that the email was addressed to
  • toemail

    • Address of the Email trigger initiating the run
  • trigger-attachment

    • The first attachment on the email. Any images in the body of the email will be treated as an attachment
  • trigger-attachment-filename

    • Filename for email attachment, including file extension
    • Any attachments that are sent through a email trigger will save to a Trigger Attachments data table
  • trigger-attachment-2 (3,4,5)

    • If the email has multiple attachments, each additional attachment is output to a unique field. The 2nd file is output to trigger-attachment-2, the 3rd file to trigger-attachment-3, and so on.
  • trigger-attachment-2-filename (3,4,5)

    • If the email has multiple attachments, each additional attachment filename is output to a unique field. The 2nd filename is output to trigger-attachment-2-filename, the 3rd filename to trigger-attachment-3-filename, and so on.
  • Trigger attachments

    • A data table with every attached file. Each table row is an attachment, and each column is an attribute of the attachment. The attribute columns listed in the table are:
      • file
        • A link to download the file.
      • Name
        • The name of the file, including the extension,
      • Type
        • The type of the file in image/png, or application/pdf format.
      • Extension
        • The file extension of the file, such as png or jpg.
      • Size in Bytes
        • The file size in bytes. This will be an integer.
      • Location
        • Either attachment or inline depending on how the recipient added the file.
  • Trigger number of attachments

    • The number of attachments included in the email.


  • Please refrain from using the words when naming your email trigger: -admin@, autoreply.*@, -autoresponder@, autoresponder@, -bounce@, bounce-@, bounce@, -bounces@, -confirm@, daemon@, -errors@, exim@, fetchmail@, httpd@, info@, lighttpd@, listmaster@, listserv@, mailer_daemon@, mailer-daemon@, mailer@, mailman@, mailmaster@, majordom@, majordomo@, nagios@, no-reply@, nobody@, noreply.*@, -outgoing@, -owner@, owner-, postmaster@, -relay@, reminder@, -request@, root@, sales@, server@, squid@, support@, webmaster@, www-data@, www@