Skip to main content

Using Integrations in Workflows

Once an integration is installed, it appears in the Custom tab of the Toolbox.

Adding an integration node​

  1. Open the Custom tab in the Toolbox.
  2. Find the integration you want to use.
  3. If it has multiple versions, select the desired version from the dropdown on the card.
  4. Click or drag the integration to add it to the canvas.

The node is created with the integration's name and description, and is pre-configured with the selected version.

Configuring inputs​

Click the integration node to open its Property Sheet. The Properties tab shows the input fields defined by the integration's input schema.

Fill in the required fields. All fields support expressions, so you can pass dynamic values from upstream nodes:

{{ Previous Node.userId }}

Upgrading to a new version​

If the integration has a newer published version available, open the node's Property Sheet. A Integration Version dropdown appears at the top of the Properties tab (only shown when multiple versions are available).

Select the new version. The property fields update to match the new version's input schema. Review and update any field values that may have changed, then click Save changes.

Integration output​

The result returned by the integration's Output node is available as the output of this node. Reference it in downstream nodes using the node's name:

{{ My Integration.result }}

The available fields depend on what the integration returns.

Execution behaviour​

When an integration node runs:

  1. The parent workflow pauses.
  2. The integration's sub-workflow executes with the input values you configured.
  3. The sub-workflow runs to completion (or fails).
  4. The result is returned to the parent workflow, which resumes.

Sub-workflow executions do not appear in the main execution log list. They are accessible only through the integration's statistics page.