🔗Action Node

This is a guide for creating and using an action node.

1. Creating a new node

• Click the Add new node button in the top-right corner to begin defining a new workflow element.

• From the dropdown, select Action node.

• A blank action node will appear at the start of the canvas, acting as a placeholder for your content.

• Drag the node to any location on the canvas—its position will be saved automatically.

Workflow canvas with an empty action node

2. Configuring an action

• Click Configure Action inside your Action Node to open the setup modal.

• The modal is organized into three sections:

  • Basic Configuration: Enter an informative Action Name and a brief Description.

  • API Configuration:

    • URL: Enter the web address you want to call.

    • Method – Select the HTTP verb (GET, POST, etc.) from the dropdown.

    • Headers – Content-Type: application/json is always included and cannot be removed; add any custom headers you need.

    • Request Body – Use the JSON editor to build your payload. You can insert shared data from the previous node at any level of nesting (arrays, objects, or combinations thereof).

  • Testing your API: Fields for each piece of shared data will appear here. Provide sample values, then click Test API to validate your setup. After you run the test, the modal displays the response details so you can confirm success or troubleshoot errors. The Create Action button remains disabled until the test returns a successful 2xx status. If you encounter problems, please reach out to [e-mail]. Once your test passes, click Create Action to save your configuration and close the modal.

Action Configuration drawer

Action Configuration drawer

NOTE: You can update an action by clicking on Update Action button.

3. Linking to a new node

After your action is saved, two connectors appear on the right side of the node:

1. Success connector : The top connector in green represents a successful API call. A tooltip is also available. Drag the success connector to the node you want to run when the API succeeds.

2. Failure connector : The bottom connector in red represents a failed API call. A tooltip is also available. Drag the failure connector to the node you want to run when the API fails.

4. Response Data sharing

After a successful API call, the action node’s shared data is forwarded exclusively to the node connected by its success handle. When using the failure handle, no shared data is passed to the next node. Nodes further downstream that aren’t connected via that submit handle will not receive the data. To inspect the shared data, Click the eye icon on the connector edge to open the Shared Data panel and review the submitted JSON form payload.

Shared Data panel on an edge connected from action to any node

NOTE: To access a action’s success output in the immediately connected node, wrap the field key in double curly braces. Eg: if your response data has title as a key, include {{response.title}} in the next node to inject that value.