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.
Input types
Input types are:
Text fields: Text input, text area, email, link and phone number
Select fields: Single select, multi select, checkbox, checkbox group and radio button group
Date time fields: Date, time and date & time
Map fields: Map
Updating inputs
Select an input by clicking on it. Once an input is selected, you can configure its properties on the opening panel.
Deleting inputs
To clone an input, click ellipsis … at top right corner of your input and select Delete.
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 type | Syntax | Example |
---|---|---|
Text | input.text | "Sample text" |
Text area | input.textArea | "This is a long text" |
input.email | "example@example.com" | |
Link | input.link | "https://example.com" |
Phone number | input.phoneNumber | "+1 123-456-7890" |
Integer | input.integer | 42 |
Decimal | input.decimal | 3.14 |
Single select | input.singleSelect | "Option A" |
Multi select | input.multiSelect | ["Option A","Option B"] |
Checkbox | input.checkbox | true |
Checkbox group | input.checkboxGroup | ["Option A","Option B"] |
Radio button | input.radioButtonGroup | "Option A" |
Date | input.date | "2023-07-24" |
Time | input.time | "14:00" |
Date & time | input.dateTime | 1690207200000 |
Map | input.map | { "key1": "value1", "key2": "value2" } |