When mapping items, you can use functions. The functions available in Integromat are similar to functions in Excel or those in other programming languages. The functions let you perform various changes to items, such as changing a bundle item to upper case, cutting selected text to a required size, converting a date into a different format, and many others. Functions are intended for advanced users.

Example: Cutting Tweet text

When writing a new Tweet, you should not exceed Twitter's 140-character limit. If you create a scenario with a Tweet containing more than the allotted amount, the scenario run will end with an error. If you map a text item that can contain more than 140 characters to be the source field for the Tweet, you may want to use the substring() function that will remove the extra characters that are over the limit.

Inserting a function into a field

Functions are inserted the same way as mapping items. By clicking a target field, it will open the mapping panel which is divided into several sections. You can switch between them by clicking them. The first section (shown upon opening the panel) displays the items that you can map from other modules. In the other sections, you will find different types of available functions.

To insert a function into a field, click the function name or drag it to the target field.

Text and binary functions

ascii(text, [remove diacritics])

Removes all non-ascii characters from a text string.

= Integromat
ascii(ěščřž, true) 
= escrz


Transforms text to base64.

= aW50ZWdyb21hdA==


Converts first character in a text string to uppercase.

= Integromat


Decodes special characters in URL to text.

= Automate your workflow


Encodes special characters in text to valid URL address.


Escapes all HTML tags in text.

= &lt;b&gt;Hello&lt;/b&gt;

indexOf(string, value, [start])

Returns the position of the first occurrence of a specified value in a string. This method returns `-1` if the value to search for never occurs.

indexOf(Integromat, t) 
= 2
indexOf(Integromat, x) 
= -1
indexOf(Integromat, t, 3) 
= 9

lower (text)

Converts all alphabetic characters in a text string to lowercase.

= hello


Calculates the md5 hash of a string.

= d155951844a40fb856108d803d4de33e

replace(text;search string, replacement string)

Replaces the search string with the new string.

replace(Hello World;Hello;Hi) 
= Hi World


Calculates the sha1 hash of a string.

= 5572e727b5822e06d7d13c69f51b3addbfa5390f

split(text, separator)

Splits a string into an array of strings by separating the string into substrings.

split(John,George,Paul; ,)


Removes all HTML tags from text.

= Hello

substring(text; start;end)

Returns a portion of a text string between the "start" position and " the end" position..

= Hel
= el


Converts any value to binary data. You can also specify encoding as a second argument to apply binary conversions from hex or base64 to binary data.

= 496e746567726f6d6174
toBinary(SW50ZWdyb21hdA==; base64) 
= 496e746567726f6d6174


Converts any value to string.


Removes space characters at the start or end of the text.


Converts all alphabetic characters in a text string to uppercase.


Math functions

average([array of values]), average(value1, value2, ...)

Returns the average value of the numeric values in a specific array, or the average value of numerical values entered individually.


Returns the smallest integer greater than or equal to a specified number.

= 2
= 4


Returns the largest integer less than or equal to a specified number.

= 1
= 1
= 4

max([array of values]), max(value1;value2; ...)

Returns the largest number in a specified array, or the largest number among numbers entered individually.

min([array of values]), min(value1; value2; ...)

Returns the smallest number in a specified array, or the smallest number among numbers entered individually.

parseNumber(number; decimal separator)

Parses a string with a number and returns the number. Example: parseNumber(1 756,456;,)


Rounds a numeric value to the nearest integer.

= 1
= 2
= 2
= 2

sum([array of values]), sum(value1; value2; ...)

Returns the sum of the values in a specified array, or the sum of numbers entered individually.

Date and time

addDays(date; number)

Returns a new date that results from adding a given number of days to a date. To substract days, enter a negative number.

addDays(2016-12-08T15:55:57.536Z; 2) 
= 2016-12-10T15:55:57.536Z
addDays(2016-12-08T15:55:57.536Z; -2) 
= 2016-12-6T15:55:57.536Z

addHours(date; number)

Returns a new date that results from adding a given number of hours. To substract hours, enter a negative number.

addHours(2016-12-08T15:55:57.536Z; 2) 
= 2016-12-08T17:55:57.536Z
addHours(2016-12-08T15:55:57.536Z; -2) 
= 2016-12-08T13:55:57.536Z

addMinutes(date; number)

Returns a new date that results from adding a given number of minutes. To substract minutes, enter a negative number.

addMinutes(2016-12-08T15:55:57.536Z; 2) 
= 2016-12-08T15:57:57.536Z
addMinutes(2016-12-08T15:55:57.536Z; -2) 
= 2016-12-08T15:53:57.536Z

addMonths(date; number)

Returns a new date that results from adding a given number of months. To substract months, enter a negative number.

addMonths(2016-08-08T15:55:57.536Z; 2) 
= 2016-12-10T15:55:57.536Z
addMonths(2016-08-08T15:55:57.536Z; -2) 
= 2016-12-06T15:55:57.536Z

addSeconds(date; number)

Returns a new date that results from adding a given number of seconds. To substract seconds, enter a negative number.

addSeconds(2016-12-08T15:55:57.536Z; 2) 
= 2016-12-08T15:55:59.536Z
addSeconds(2016-12-08T15:55:57.536Z; -2) 
= 2016-12-08T15:55:55.536Z


Returns a new date that results from adding a given number of years. To substract years, enter a negative number.

addYears(2016-08-08T15:55:57.536Z; 2) 
= 2018-08-08T15:55:57.536Z
addYears(2016-08-08T15:55:57.536Z; -2) 
= 2014-08-08T15:55:57.536Z

formatDate(date; format; [timezone])

Returns a date in the requested format and optionally in specified timezone. For example, format DD.MM.YYYY HH:mm

formatDate(2016-12-28T16:03:06.372Z; MM/DD/YYYY)  
= 12/28/2016
formatDate(2016-12-28T16:03:06.372Z; YYYY-MM-DD hh:mm A)  
= 2016-12-28 4:03 PM
formatDate(2016-12-28T16:03:06.372Z; DD.MM.YYYY HH:mm; Europe/Prague)  
= 28.12.2016 17:03

parseDate(date; format; [timezone])

Parses a string with a date and returns the date.

parseDate(2016-12-28; YYYY-MM-DD) 
= 2016-12-28T00:00:00.000Z
parseDate(2016-12-28 16:03; YYYY-MM-DD HH:mm) 
= 2016-12-28T16:03:00.000Z
parseDate(2016-12-28 04:03 pm; YYYY-MM-DD hh:mm a) 
= 2016-12-28T16:03:06.000Z
parseDate(1482940986; X) 
= 2016-12-28T16:03:06.000Z

Function for working with arrays

add(array; value1; value2; ...)

Adds values specified in parameters to an array.

join(array; separator)

Concatenates all the items of an array into string, using the specified separator between each item.


Returns an array of a given object's or array's properties.

remove(array; value1; value2; ...)

Removes values specified in parameters from an array. Effective only on primitive arrays of text or numbers.

slice(array; start; [end])

Returns a new array containing only selected items.

Rate this article: