Loading...
Skip to main content

Conditional Control Flow with the If Node

Introduction

Automations can conditionally execute a branch of the workflow. This can be useful in any case where you may want to change the actions of an automation based on certain data sent with the template.

For example, you may want to send one template if one data field represents a certain value, or another template if it does not:

Condition Sources

The Control Flow If node has four different source options, data, profile, step ref and JS condition. These sources control whether to follow the True path or the False path by evaluating the sources.

Data

Compare a field within the data key within the automation context with a value. For example:

ConditionAutomation PayloadEvaluation
data flow condition - not equals
{
"recipient": "user123",
"data": {
"foo": "bar"
}
}
True
data flow condition - one Of
{
"recipient": "user123",
"data": {
"throw": "scissors"
}
}
False

Profile

Compare a field within the data key within the automation context with a value. For example:

ConditionAutomation PayloadEvaluation
profile flow condition - equals
{
"recipient": "user123",
"profile": {
"user_id": "user123",
"first_name": "bryan"
}
}
True
profile flow condition - one of
{
"recipient": "user123",
"profile": {
"user_id": "user123",
"properties": {
"roles": [
"admin",
"developer"
]
}
}
}
True

Step Ref

Step Ref is designed for you to check the status of a Send node. In order to use Step Ref, you must have a Send node and have the alias of the Send node defined in its configuration.

CLICKED | DELIVERED | ENQUEUED | FILTERED | OPENED | SENT | SIMULATED | UNDELIVERABLE | UNMAPPED | UNROUTABLE

Automation Control Flow

JS Condition

Sometimes the value checking is not open ended enough to evaluate a condition. Using the JS Condition you can:

  • manipulate the field value before comparing
  • check for key existence
  • Comparing date diffs as ISO strings
  • manipulate nested arrays and objects

We will evaluate the manipulation into a Javascript Boolean after the equation

ConditionAutomation PayloadEvaluation
js condition value - map includes
{
"recipient": "user123",
"data": {
"names": [
{
"name": "Alvin"
},
{
"name": "Simon"
},
{
"name": "Theo"
}
]
}
}
False

JS Condition Values

Within the Data, Profile and Step Ref Sources, you may also use JS String evaluation in the value field

ConditionAutomation PayloadEvaluation
js condition value - date
{
"recipient": "user123",
"data": {
"ts": 1095869760000
}
}
True

Tutorial

Below you can find a walkthrough of a sample control flow using step references.