Array Utilities

Append To Array

Append an element to an array.

Parameter	Description
Array	The source array to append the element to.
Element To Append	The element to append to the array.

Append To JSON List

Append an object to a list within a JSON object. The object will be added even if it already exists within the list.

Parameter	Description
Existing JSON List Or Object	The JSON list or object to which the new object will be appended. Note that nested keys are only applicable to JSON objects, not lists. If the existing JSON is a list, direct appending to the end of the list is used. Also, ensure that the nested key provided points to an existing JSON list inside the JSON object.
JSON Object To Append	The object data to append.
Nested Object Key	The nested object key to append the data to. This parameter can only be used when the existing JSON is an object.

Append To List (Deprecated)

This utility has been deprecated and will no longer be available in new workflows. You can use Append To Array instead.

Append an item to the end of a list. If the variable does not exist, the action will create a new list automatically.

Parameter	Description
Variable Name	The name of the variable.
Item	Item to add to list.

Compare Arrays

Compare two arrays and determine if they are equal.

Parameter	Description
First Array	The first array to compare with the `Second Array`. Value must be a valid array or a comma-separated list.
Second Array	The second array to compare with the `First Array`. Value must be a valid array or a comma-separated list.
Ignore Order	When checked, arrays will be considered equal even if elements appear in a different order.
Loose Typing	When checked, enables type coercion during comparison (e.g., number `12` equals string `"12"`, boolean `true` equals string `"true"`).

Concat Arrays

Combine two arrays into a single array containing all elements from both.

Parameter	Description
First Array	The initial array whose elements will appear at the beginning of the result. Value must be a valid array or a comma separated list.
Second Array	The array whose elements will be appended after the first array. Value must be a valid array or a comma separated list.
Remove Duplicates	When checked, repeated values in the final combined array are removed.

Extract Field From Array

Extract a specific field from each item in an array and get the values as a new array.

Parameter	Description
Array	The array from which to extract the specified field. Value must be a valid array or a comma-separated list.
Field Path	The name or path of the field to extract from each array item. For top-level properties, simply use the property name (e.g., `id`). For nested properties, use dot notation (e.g., `details.id`). For example, given this array: `[{"userId": "user123","details": {"id": "id123"}},{"userId": "user789","details": {"id": "id789"}}]` Using `userId` would extract: `[“user123”, “user789”]` Using `details.id` would extract: `[“id123”, “id789”]`
Skip Missing	When checked, records with missing fields will be excluded from the result. When unchecked, records with missing fields will be included with `null` values.
Remove Duplicates	When checked, repeated values in the final array are removed.

Extend List

The Extend List utility action allows you to append an item to the end of your list or append a second list onto the end of your original list. You can choose the list you want to append to by clicking on the dynamic dropdown menu and selecting your preferred list.

Parameter	Description
Variable name	The name of the original list variable
List to append	The name of second list to append.
Value	Name of the item to append to the list

The Extend List utility action enables you to:

Append a variable to the end of an original list

Append a second list to the end of an original list

Append both a variable and a second list to the end of the original list

Filter Array

Filter array elements using a Filter Function.

Parameter	Description
Array	The array to be filtered. Value must be a valid array or a comma-separated list.
Filter Function	A Python function that determines which elements to keep in the array. The `Filter Function` is executed individually for each element in the input `Array`. For every element, the function should: Return `True` if you want to include that element in the resulting filtered array. Return `False` if you want to exclude that element. For example: `def even(n): return n % 2 == 0`

Get Array Length

Get the number of elements in a specified array.

Parameter	Description
Array	The array to get the length of. Value must be a valid array or a comma-separated list.

Get Item From Array

Get a single item from an array at the specified index position.

Parameter	Description
Array	The array from which to retrieve an element. Value must be a valid array or a comma-separated list.
Index	The position of the item to get. The first item has an index of `0`.

Get Random Item From Array

Get a random item from a specified array.

Parameter	Description
Array	The array from which to select a random item. Value must be a valid array or a comma-separated list.

Remove Duplicates From List

Removes duplicate elements from a list.

Parameter	Description
List	The JSON list to remove duplicates from. For example: The input list `[1,2,2,1]` will result in the output list `[2,1]`.

Remove From JSON List

Remove an object from a list within a JSON object. All instances of the object will be removed from the list.

Parameter	Description
Existing JSON List Or Object	The JSON list or object from which the object will be removed. Note that nested keys are only applicable to JSON objects, not lists. Also, ensure that the nested key provided points to an existing JSON list inside the JSON object.
JSON Object To Remove	The concrete object to remove. Ensure that the provided object is equal to the desired object to remove.
Nested Object Key	The nested object key to remove the data from. This parameter can only be used when the existing JSON is an object.

Reverse List

Reverses the order of elements in a list. For example: The list [8,12,2,6] will result in the output list: [6,2,12,8].

Parameter	Description
List	The JSON list to reverse. For example: The input list `[1,2,3]` will result in the output list `[3,2,1]`.

Slice Array

Slice elements from an array between Start Index and End Index. The new array will contain elements from the source array beginning at Start Index (inclusive) up to but not including End Index (exclusive).

Parameter	Description
Array	The array to slice elements from. Value must be a valid array or a comma-separated list.
Start Index	The index of the first element to include in the slice. The first element of the array has an index of `0`. Defaults to `0` if not specified, effectively starting from the beginning of the array.
End Index	The index of the element after the last element to include in the slice. The slice includes elements up to, but not including, this index. If not provided, the slice will go to the end of the array.

Sort Array

Sort array elements of the same type in ascending or descending order.

Parameter	Description
Array	The array to be sorted. Value must be a valid array or a comma-separated list.
Order	Select the sorting direction for the array.
Comparison Function	A Python function used to extract a comparison key from each element. Used for sorting complex or mixed-type arrays. This function must return a comparable value. For example: `def myFunc(item): return item[‘property’]`

Split Array

Split a single array into multiple smaller arrays (chunks) of a specified size.

Parameter	Description
Array	The array to be sorted. Value must be a valid array or a comma-separated list.
Chunk Size	The maximum size of the chunks that will be created.
Get Response As JSON Object	Select to get the result as JSON object instead of a nested array.

Workflow Basics

Triggers

Actions

Builder Copilot

Connections

Variables

Files

Templates

Publishing Workflows

Error Handling and Debugging

Workflow Management

Packs

Append To Array

Append To JSON List

Append To List (Deprecated)

Compare Arrays

Concat Arrays

Extract Field From Array

Extend List

Filter Array

Get Array Length

Get Item From Array

Get Random Item From Array

Remove Duplicates From List

Remove From JSON List

Reverse List

Slice Array

Sort Array

Split Array

​Append To Array

​Append To JSON List

​Append To List (Deprecated)

​Compare Arrays

​Concat Arrays

​Extract Field From Array

​Extend List

​Filter Array

​Get Array Length

​Get Item From Array

​Get Random Item From Array

​Remove Duplicates From List

​Remove From JSON List

​Reverse List

​Slice Array

​Sort Array

​Split Array

Append To Array

Append To JSON List

Append To List (Deprecated)

Compare Arrays

Concat Arrays

Extract Field From Array

Extend List

Filter Array

Get Array Length

Get Item From Array

Get Random Item From Array

Remove Duplicates From List

Remove From JSON List

Reverse List

Slice Array

Sort Array

Split Array