Help

Item data types

Every bundle always contains several items. Their type may differ. Integromat distinguishes the types of items described below.

Tip: Detailed information on which types of items Integromat allows to convert between each other can be found in the Type coercion section.

Text

The most common type is text. For some text items, Integromat checks whether the maximum or minimum allowed length is met or performs format validation (email, URL or file name).

Number

For some numerical items, Integromat may validate the input for a specified range (the minimum or maximum allowed value).

Boolean (Yes/No)

This type is used for items with only two possible values: true or false. An example is the This document is private option shown when creating documents with the help of the Basecamp modules.

When setting modules, the Boolean type can appear in two different forms:

The compulsory check box is shown in case the field is mandatory and must be filled in.


Optional fields that can be left blank are displayed as a selection box allowing selection among three values: Yes, No and Not defined(default).


If you need to map an item from another module, click the Map button. This will allow you to map the value to a text field.

Date

The date is entered in the ISO 8601 date format, e.g. 2015-09-18T11:58Z.

The time zone can be adjusted in the profile settings. If you fill in a field that requires entering a date, the pop-up calendar will be displayed in the module settings. The time is not required for some items.


Time

The time is entered in the hours:minutes:seconds format, e.g. 14:03:52.

Buffer (binary data)

The file content is usually sent as Buffer type (image content, video file and others). In some cases, there are text data included in this type (e.g. text file). Integromat is able to automatically convert text data in binary code to text (and vice versa). For more information on working with files see the Working with files section.

Collection

A collection is an item consisting of several subitems. An example of the collection is the Sender item in an email message. It contains the sender name (text type) and the sender email address (text type).

Select (menu)

When you configure the module settings, the select menu lets you select from several items of the same type. An example is the folder select menu in the settings of the Dropbox modules.

When setting modules, the select menu can appear in two forms:

If multiple selection is possible, several items provided with a check box will be displayed below each other.


If only one option is possible, a drop-down menu will be shown. Clicking this menu will bring up a selection of available options.

If you need to map an item from another module, use the Map button. Clicking this button will open a text field instead of the selection menu.


Array

The array type is used for working with several values of the same type, including collections. E.g. the Email modules return an array of attachments and each attachment contains name, content, size and the like.

For more information about arrays please see the Working with arrays section.

Validation

Integromat may perform validation for each type of item. If an item does not pass the validation, module processing will terminate with the DataError. The Twitter modules, for example, do not allow to send a tweet (text type) exceeding the allowed maximum of 140 characters. If you try to send a tweet with more than 140 characters, your scenario will encounter this error.

Rate this article: