Events

flo_diagram

A Flow is a series of cards that run from left-to-right. The Event, when you provide one, is always the first card. Flows with an event trigger automatically (after the Flow has been turned on) based on the type of event.

The different types of events are:

  • Application Events - The Flow runs automatically based on an application event, e.g. when there is new email, a new customer, a spreadsheet is updated, a deal is closed, or any of hundreds of application events to choose from, with new ones added every month.
  • Schedule - Flow runs on a schedule, e.g. runs every hour, once a day, Mondays at 9am, or on a custom schedule of your choice.
  • Form - Flow runs each time a user clicks Submit on a simple, custom web form.
  • Child Flow - Flow runs when called from another Flow, such as to process a list or handle errors. (These don’t count against your active Flow limit.)
  • API Endpoint - Flow runs when invoked via an HTTP call using inputs that you specify.

Event cards have output fields that can be used to pass data from the event to other steps in the Flow for further action. For example, if your Flow’s event is New Email in Gmail, then the Flow will kick off once for every new email you receive. The outputs of the event card are assigned values based on each new email – e.g. From, Subject, Body, etc. – that you can take action on, such as looking up to see if the email  address is already in your customer database, checking to see if the subject line contains a special keyword, or whatever is necessary to automate your custom process. You can manipulate the data with built-in text, math, object and list functions and add custom logic and branching to handle different conditions – all without having to write code.

abstract_flo_example

To do this, add your additional Action and Function cards after the Event, and then drag output fields and drop them into input fields inside subsequent cards, as pictured above. When the Flow runs, the output values for each instance will pass into the inputs for the later steps.

Advanced Event settings

Using the buttons on the bottom of the event card, you can customize the event in the following ways:

  • Change how often to check for new data - Most events poll the connected application for new data every 5 minutes by default (e.g. checking Twitter to see if there have been any new Tweets). You can change the polling schedule to a custom schedule, such as every hour or once a day. Note: events that are labelled “webhook” work differently:  These Flows are called directly by the application immediately after there is new data, so webhook events don’t support custom schedules.
  • Change how the Flow runs - by default, a Flow runs once for each chosen event, e.g. once for each new, updated, or deleted item. If there are 10 new items since the last time the Flow ran, then the Flow will run 10 times – once for each new item. For advanced scenarios, you can set the Flow return a list of all new items instead or to only run when there are no new items.