Start a workflow with a SharePoint event

From Nintex K2 Cloud Update 21 onwards there are two different apps for SharePoint Online. The legacy Nintex K2 Cloud for SharePoint app: used for SharePoint upgraded tenants, and the Nintex K2 Cloud (SPFx) app: used for new tenants.

You can configure workflows that you design using the Workflow Designer to start from a SharePoint event, such as an item added to a list. You choose the SharePoint event during configuration of the Start step in the Workflow Designer.

When working with the Start a Workflow with a SharePoint event option, keep in mind the following:

You can use any SharePoint list or library to start the workflow.
The SharePoint list or library does not have to be integrated with the product.
Workflows designed with the Workflow Designer and then linked with a SharePoint list or library to start the workflow, are not stored in the SharePoint category. To ensure the workflow displays in the correct K2 for SharePoint category, you need to create the workflow in the same category as the corresponding K2 for SharePoint items.
If the workflow is created in the default Workflow category, you can open or edit this workflow from the Workflow Designer.

A workflow can only start with one single SharePoint event.

Best practice: Create a workflow by integrating a SharePoint list or library with the product.

Example of a workflow configured to start with a SharePoint event

How to start a workflow with a SharePoint event

Create a workflow. Type the workflow name and select the SharePoint category folder.

If no category is selected the workflow is created in the default Workflow folder. It is recommended that you create a category to keep all objects related to the workflow together, and perhaps group them by business function or department.

Select the Start step and click the expand / collapse toggle to expand the Configuration Panel. You can also double click the step to expand the panel.

For more information on how to configure a condition on the start rule, see the Conditional Start Rule topic.

Select the Start with a SharePoint List option.
From the Select a SharePoint List / Library page, browse to the list or library. Click OK.

For more information about the different browse states and errors, see the Browse States topic.

For more information on how to use the breadcrumb bar, see the How to use the Breadcrumb topic.

The References are displayed as follows:

This page inspects the list or library to determine all the data sources that can be used to populate references within the workflow. Any data source to item reference matches found are then grouped together.

If no data sources matches are found, any unmatched data sources are set to Create Item Reference. If matching data sources are found, any unmatched data sources default to Do Not Create Item Reference.

In this example, two data sources were found in the form. Click the deselect icon to deselect and not create item references.
Click Next. The Triggers page displays. Select a trigger by checking the check box. You can select more than one trigger to start the workflow. In this example, select the An item was added option.

Make use of the Previous button to return to the previous page of the wizard.

Click Next. The Almost Done page displays. This page contains all actions to complete during the setup wizard. Click Save and Finish.
The Success page displays when done. Click OK.
The setup and configuration are complete.
To view the references, click the expand / collapse toggle to expand the Context Browser. Select the Fields tab and click References.
To edit the list or library configuration, click the Edit link. Click Next to step through the configuration wizard again.
To delete the list or library configuration, select it and click the Trash bin.
Click the Delete Event button.
Your changes are automatically saved.