Skip to main content

Inputs

Learn about input components and how to use them in your manual workflows.


Overview

Inputs are the fields for collecting information to run a workflow manually by submitting a form in Slack. Manual workflows are run with the values of inputs, execute actions, and generate outputs accordingly.

Text field to enter the name of a HubSpot deal or a dropdown to select the Zendesk users can be the inputs in your manual workflows.

To view and update the inputs of a workflow, open your workflow in Canvas mode and navigate to first node.

Adding new inputs

Open your workflow in Canvas mode, navigate to first node. On the opening panel, click + Add new field to create a new input.

Add an input component

Input types

Input types are:

Updating inputs

Select an input by clicking on it. Once an input is selected, you can configure its properties on the opening panel.

Input properties

Deleting inputs

To clone an input, click ellipsis … at top right corner of your input and select Delete.

Delete an input

Reordering inputs

To change the order of an input, click on it and while holding the mouse button down – drag to a new location.

Input properties

ID is a unique value among all input components of a workflow. It is used to get the entered or selected value.

To get the entered or selected value of an input component, use below: {{input.input_id}}

Label is what is displayed as the name of the component when the workflow is run.

Placeholder is the text displayed when no value is entered or selected for the input. It can be used as a tip to inform the users on what data to enter or select to run the workflow.

Helper text is placed as a small note under the input. It contains additional notes or hints about what kind of information should be provided to run the workflow.

Mandatory: Once this option is enabled, filling out a value for that input becomes mandatory to run the workflow.

Search: Can be set for single-select and multi-select fields. It provides search-as you-type functionality. When enabled, only the options with the matching display values are suggested as options when the user types in this field.

Custom values: Can be set for single-select and multi-select fields. It allows users to enter their own choices, even if they are not available in the predefined dropdown options.

Sources: Can be set for select fields.

→ Learn how to configure sources for single select inputs.

Validations: Can be set

  • for min and max character length of text and text area inputs
  • for min and max number of options that can be selected in a multi select input
  • as regular expressions to filter entered or selected value

Default value: is the value that the input takes when the form is opened.

Retrieving data from inputs

The input variable is reserved for manual workflows. To retrieve the value of a specific input during workflow execution, use the notation input.myInput, where myInput represents the ID of the input.

Input typeSyntaxExample
Textinput.text"Sample text"
Text areainput.textArea"This is a long text"
Emailinput.email"example@example.com"
Linkinput.link"https://example.com"
Phone numberinput.phoneNumber"+1 123-456-7890"
Integerinput.integer42
Decimalinput.decimal3.14
Single selectinput.singleSelect"Option A"
Multi selectinput.multiSelect["Option A","Option B"]
Checkboxinput.checkboxtrue
Checkbox groupinput.checkboxGroup["Option A","Option B"]
Radio buttoninput.radioButtonGroup"Option A"
Dateinput.date"2023-07-24"
Timeinput.time"14:00"
Date & timeinput.dateTime1690207200000
Mapinput.map{ "key1": "value1", "key2": "value2" }