Skip to main content

Start a Workflow from a Webhook, Form, or Email

Three triggers let the outside world start a workflow. All three are set up in the visual builder.

Start from another system (webhook)​

  1. Drag Webhook received onto the canvas, add the steps, save and activate. The trigger then shows the workflow's own address.
  2. Copy the address into the other system. It should send JSON with POST; the data is available as {{Body.orderId}} and so on.
  3. Recommended: press Make a secret, copy the secret into the other system (it is shown once) and tick Refuse calls that are not signed.
  4. If the sender may retry, have it send an Idempotency-Key header: the same key twice starts the workflow once.

Each call starts one run and gets back the run id. A wrong or missing signature is refused. New address replaces the address at once if it leaks.

Put a form behind a QR code​

  1. Drag Form submitted onto the canvas. Enter the form title, an introduction and the fields (short or long text, number, date, choose one, tick any, yes/no, photo or file). Mark the required ones.
  2. Optional: under QR code points at, choose a record type, such as an item, to print one QR code per record. The workflow then gets {{RecordRef}} and {{Record.*}}.
  3. Add the steps (for example an email to maintenance with {{Fields.Machine}}), save and activate.
  4. Under the trigger, press Show QR, download it and print it.

The form opens on any phone with no account. Photos up to 5 MB are kept with the run, and each submission starts one run. New address stops old QR codes at once.

Start from an email (bills, orders)​

  1. Ask us to switch on email-in for your server (a one-time setup). Then open Automation → Settings → Email addresses, type a name such as bills, and press Add address.
  2. Give the address to suppliers, or forward mail to it. Nobody needs a mailbox or password.
  3. In the visual builder, drag Email received onto the canvas and choose the address. For bills, list the senders you accept (an address, or @supplier.com for a whole domain), and keep Ignore mail marked as spam on.
  4. Add Read a document to read the attached PDF or photo, then use {{steps.doc.Supplier}}, {{steps.doc.Number}} and {{steps.doc.Total}} in later steps, for example an Ask a person form for accounts to check it.
  5. Save and activate.

Each new email starts the workflow once, with {{From}}, {{Subject}}, {{TextBody}} and its PDF and image attachments. The same email sent twice starts nothing new. Mail to an unknown or old address is dropped.

:::info Limits Email-in reads PDF and image attachments only (up to 10 MB each, 10 per email). Read a document returns header fields (supplier, number, date, total, tax), not line items, and does not create a purchase bill. Public forms use a simple bot check, and an answer cannot be edited after it is sent. :::