Call a workflow

Use the Call a workflow action A tool for building the processes, logic, and direction within workflows. Actions are the steps the workflow performs to complete a process. to call a Component workflow A workflow that can be started from outside the tenancy; the workflow uses the "Component workflow" start event., which handles a common task or sub-process.

Parent and children workflows are tied together. When a parent workflow is terminated, related child workflows also terminate. If a child workflow configured to complete before the parent resumes is terminated, then the parent will also terminate.

For example, many HR processes may involve the task of looking up IDs for employees. In this case, you can set up a child Component workflow for ID lookup and call that child workflow from each relevant HR workflow using this action.

Configure the Call a workflow action

1. Add the action to the workflow and open the action configuration panel. For more information, see Add an action to the workflow.

2. For Workflow, select the Component workflow A workflow that can be started from outside the tenancy; the workflow uses the "Component workflow" start event. you want to call. When inserting a variable use the workflow ID of the workflow.

   Important:  Before adding a variable to this field, you must select a component workflow from the drop-down list to retrieve the input and output fields for configuration. After the input and output fields are configured, you can replace the workflow with a variable.

3. Select if you want the workflows to run concurrently or wait for this workflow to complete before continuing.

4. Complete the fields for any inputs Variable to store a value or file when the workflow starts. Set up as a start event variable. and outputs Variable to store a value or file on completion of the workflow. Set up as a user-defined variable. that are rendered for the selected workflow. In addition, if desired, in the Instance ID field, specify a variable to store the ID of the initiated instance; this can be helpful if you want task data or timing information from the instance or if you want to stop the instance.

   Important: File variables are not supported.

Call a workflow action fields, buttons, and settings

Section	Field	Description	Variable type
(unlabeled)	Workflow	The component workflow to call using this action. When inserting a variable use the workflow ID of the workflow you want to call. Important:  Before adding a variable to this field, you must select a component workflow from the drop-down list to retrieve the input and output fields for configuration. After the input and output fields are configured, you can replace the workflow with a variable. If you use a variable, the workflow you trigger should have the same inputs and outputs. For information about getting the workflow ID of a component workflow from the base URL, see Endpoints and responses.	Text
	Run both workflows concurrently	When selected, the current parent workflow will keep running after the selected component workflow starts. When this option is selected, the Output variables will not be populated.	(n/a)
	Wait for this workflow to complete before continuing	When selected, pauses the current (parent) workflow until the selected component workflow is completed. Use this option to reference outputs of the selected workflow later in the current workflow.	(n/a)
Inputs	(start event variable for selected workflow)	Value to pass to the selected workflow as the workflow input Variable to store a value or file when the workflow starts. Set up as a start event variable.. For setup details within the Component workflow to be called, see Nintex - Component workflow.	varies
Outputs	(output for selected workflow)	Variable to store the value received from the selected workflow as the workflow output Variable to store a value or file on completion of the workflow. Set up as a user-defined variable.. For setup details within the Component workflow to be called, see Nintex - Component workflow. For Instance ID, if desired, specify a variable to store the ID of the initiated instance; this can be helpful if you want task data or timing information from the instance or if you want to stop the instance.	varies