Add List Item

The Add List Item action allows you to dynamically add a record to a list.

The Add List Item action on a blank board

The Add List Item action could be used to automatically add new subscribers to a list when they opt in for SMS promo campaigns. When you use this action, a new row is added to an existing list.


Check out the video below to learn more about how you might configure this action within your flow.


Available Variables

Available Variables are placeholders for information that are automatically determined based on the contents of your flow. For example, if your flow begins with an Inbound Call trigger, the caller’s phone number is stored as a $ANI variable. You can include sending a follow up SMS to the caller later in your flow by including the $ANI variable in the Send SMS action Inputs.

You can drag and drop the variables displayed in this section into the Inputs and Advanced fields.

Check out How to Use Variables in SmartFlows for more information.



Note: Before configuring this action you must have a list added to the List Management page. We recommend having the List Name and exact field name(s) on hand.


Input Name Description
Select List* Select the list you want to add an element to from the dropdown options. *This is a required field.


List Field Values

Select the list fields to add and assign the respective values (static or variable). On the left, the available list fields correspond to the column headers in your list.

To add more list fields, click the blue plus sign.

In the example below, new recipient John Doe is added to a list by selecting the fields “firstname” and “lastname” on the left and entering the respective values in the textbox on the right.

The List Field Values section of the Configuration Panel



Each Add List Item action includes two exit ports corresponding to the following outcomes:

  • On Match Found: The course of the flow if the list is successfully found (port 1)

  • On No Match Found: The course of the flow if the list is not successfully found (port 2)

An action must be connected to each of the exit ports to deploy your flow and the port order cannot be rearranged.


For more information about other List Management actions check out: