Run workflows on incoming email.

event-workflows-getting-started-header

​
Overview

Email-based workflows are triggered by incoming emails. You can designate a unique email address for each workflow, such as prefix.my-app@fastgenapp.com. Whenever an email is sent to this address, the corresponding workflow will be initiated.

You can access details of the incoming email using the $param variable.

Example $param content
{
  "attachments": [
    {
      "FileName": "fastgen-docs.pdf",
      "MimeType": "application/pdf",
      "Disposition": "attachment",
      "Related": true,
      "ContentId": "<f_lu9z06831>",
      "FileUrl": "https://attachments.fastgen-storage.com/seqWGaGNfADffidG7ViEulvyhFsgkVawOdlgbdXTR8ac8DDbZLLisn6KbhmBTXIkxFx1vOIhqIPd1m5YDQTs5MKosDUcutdcBJ2KwjabpyCf3RkMORnD1FI4g1LZxxOe.pdf"
    }
  ],
  "bcc": null,
  "cc": [
    {
        "Name": "",
        "Address": "cc@example.com"
    }
  ],
  "date": "2024-03-27T15:31:18.000Z",
  "from": {
    "Name": "John Doe",
    "Address": "john@fastgen.com"
  },
  "html": "<div dir=\"ltr\">This is a test email.<div><br></div><div>Good luck!<br clear=\"all\">\n\n",
  "inReplyTo": "",
  "messageId": "<CAFuLo8jgOdO7hS+EExc96Cyq3jrWr4zvNT9GmxnncqB9SBKR9g@mail.gmail.com>",
  "references": "",
  "replyTo": {
    "Name": "",
    "Address": ""
  },
  "subject": "Hi World",
  "text": "This is a test email.\n\nGood luck!\n-",
  "to": [
    {
      "Name": "",
      "Address": "prefix.cycle-magic@fastgenapp.com"
    }
  ]
}

You than can access e.g. the email text content with $param.text

​
Attachments

You can access the attached files via the URL provided at FileUrl. Please note, the link will remain valid for 7 days.

Time-basedIf