How to create an action block

To better demonstrate this process, we'll be using an example from the Integrations Quickstart template in the following sections. We recommend reviewing the quickstart so you can follow along.

Create an action block

1. In your app feature, open the Workflow Blocks tab.
2. Click Create New.
3. Select Action.

Add your block's fields and URLs

1. Basic details

Add a descriptive name for your block.

2. Configure your block's fields

The output fields in the trigger block feed into the input fields of your action block. In this way, we are mapping the relevant trigger output fields directly into your action’s input fields.

The “types” of input fields for your custom action are dictated by where the field is coming from. In the dropdown menu for any input field, you can see there are three options:

• Context - Get the value of this field from the context in which the action is executing (for example the userId of the user who set up the recipe, or the boardId of the board in which the recipe was set up).
• Trigger Output - Get the value of this field from one of the output fields of your recipe trigger (for example the itemId of the item whose Status column was used to trigger the recipe).
• Recipe Sentence - Get the value of this field from the configuration chosen by the user in the recipe sentence.

3. Configure your block's sentence

Your action sentence describes what action or event your app will accomplish. The example from the Quickstart Integrations template is “translate it into {text column, targetColumn}.”

Your action sentence can contain fields that are configurable by the user. In order to add a field to your sentence, use the {FIELD_LABEL, FIELD_KEY} format.

For example, “When {text column, columnId} changes, translate it {to, transformationType} into {text column, targetColumn}”.

📘

NOTE

The max character limit for a sentence is 255 characters. We recommend making recipes short and easily configurable, breaking the logic into multiple recipes if necessary.

API Configuration

Add your block's Run URL. Read the Custom Action Reference to learn how your app's Run URL should be configured.

Publish Settings

Select "Enable to publish" if you want your block available in the custom automation builder.