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)
- Drag Webhook received onto the canvas, add the steps, save and activate. The trigger then shows the workflow's own address.
- Copy the address into the other system. It should send JSON with
POST; the data is available as{{Body.orderId}}and so on. - Recommended: press Make a secret, copy the secret into the other system (it is shown once) and tick Refuse calls that are not signed.
- If the sender may retry, have it send an
Idempotency-Keyheader: 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
- 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.
- 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.*}}. - Add the steps (for example an email to maintenance with
{{Fields.Machine}}), save and activate. - 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)
- 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. - Give the address to suppliers, or forward mail to it. Nobody needs a mailbox or password.
- 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.comfor a whole domain), and keep Ignore mail marked as spam on. - 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. - 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. :::
Related articles
Learn more about Biznsbook Automation on biznsbook.com.