Automation Editor
Building Automations

Your first automation

9min

From any screen, click the "create an automation" menu at the top of the screen. Alternatively, from the dashboard you can also click the button at the top left:

Document image


A minimal automation consists of one trigger and one action. Click the plus icon to add a trigger:

Document image


A menu of options will appear:

Document image


Add an app: select this if you know which app you want to use

System utility: lists built-in system utility triggers

Find a trigger: find triggers by their names or descriptions. For example, if you want to receive an online form submission, you can search for "form" and view all implemented apps and triggers related to form processing.

Select the "add an app" option and then search for CNBC and click the app to add it to the automation:

Document image


The CNBC app has a single trigger. Select it:

Document image


The CNBC app requires no account connection in order for it to fetch data from the CNBC RSS news feed. If the selected app did require a connection, the system would walk you through connecting an account to the app.

This trigger has no settings that need to be configured, so click the button to save it:

Document image


Now add an action by clicking the plus icon:

Document image


A menu of options will appear:

Document image


Add an app: select this if you know which app you want to use

Transform data: lists various types of data transformations for converting data from one format to another

System utility: lists built-in system utility actions

Find an action: find actions by their names or descriptions. For example, if you want to add a contact to a CRM system, you can search for "add contact" and view all implemented apps and actions related to adding contacts.

Conditional branch: see Conditional branches

Loop: see Array Iterators

Select the "transform data" option and choose the Transform Text app:

Document image


Then scroll down the list and choose the "uppercase" action:

Document image


The Transform Text app requires no account connection. If the selected app did require a connection, the system would walk you through connecting an account to the app.

The system shows a dialog with settings and field mappings that can be configured for the action. We will build this automation to capitalize the article titles and descriptions. Enter "Title: " followed by a space into the "value" field, then open the trigger fields via its caret icon:

Document image


Then click on "article title" in the list of trigger fields to add that field to the "value" mapping:

Document image


The article title field is now mapped into the value field. When the automation runs, article titles will be inserted into the value field at that position in its text.

Add a new line and repeat for the article description:

Document image


Now the action is configured as we want for the test, so click the button to save it:

Document image


Click the Save button at the top of the screen to save the test automation. Since its name field is empty at the top, the system will auto-generate a name for you:

Document image


Click the Polling button so the system will run the automation at the default polling cycle of every 15 minutes:

Document image


Finally, save the automation by clicking OK:

Document image


Let's do a quick test and run the automation manually in test mode. From the automation's gear menu in the dashboard, choose to execute it:

Document image


Then select test mode and click the Execute button:

Document image


The automation will execute. When complete, it should show 3 successes. Click the tile to drill down:

Document image


Then click a data row to drill down again:

Document image


Now mouse over the uppercase action and see that your automation uppercased the title and description text from the CNBC article:

Document image


Congratulations, you just built your first automation!