SharePoint on-premises - New list item

Use the SharePoint on-premises - New list item start event An event that triggers a workflow to run when it occurs. An example is Box - New file, which triggers the workflow to run when a new file is uploaded to the specified folder. to start your workflow whenever a new list item is created in a specified SharePoint on-premises list. For more information on SharePoint on-premises and its other start events and actions, see SharePoint on-premises.

Select the SharePoint on-premises - New list item start event

1. Open your workflow and in the designer canvas, click Start event.

   The start event configuration panel is displayed.

2. In the Start from drop-down list, under CONNECTORS, select SharePoint on-premises.

   The Event field is displayed.

3. For Event, select SharePoint on-premises - New list item.

   The Configuration section is displayed to configure the start event.

Configure the SharePoint on-premises - New list item start event

1. In the Configuration section, select a SharePoint on-premises Connection. If you do not have a connection, see Add a connection.

2. Type a SharePoint site URL and click .

   All the lists in the specified site are displayed in the List name drop-down list.

   Example: https://domain.sharepoint.com/sites/hr

3. Select the List name that you want to monitor for this start event.

SharePoint on-premises - New list item start event variables

You can view the start event variables automatically added to the workflow.

1. In the designer canvas, click Start event to open the configuration panel.
2. Click Show variables.

   The Variables pane opens and displays the start event objects and variables. The following start event variables are available in an object called Start variable.

   Start event objects and variables

   • Site Context: (Object) that includes the following variables for the workflow:
     • Site ID: (Text) The unique identifier of the selected site.
     • Site URL: (Text) The URL of the site.
     • Site Title: (Text) The title of the site.
     • List ID: (Text) The unique identifier of the list.
     • List URL: (Text) The URL of the list.
     • List Name: (Text) The name of the list.
   • Attachments: (Boolean) The attachments of the item that starts the workflow.
   • Compliance Asset Id: (Text) The unique identifier of the compliance asset of the item that starts the workflow.
   • Content Type ID: (Text) The unique identifier for the content type of the item that starts the workflow.
   • Created: (DateTime) The created date of the item that starts the workflow.
   • Created By (Display Name): (Text) The display name of the user that created the item that starts the workflow.
   • Created By (Email): (Text) The email of the user that created the item that starts the workflow.
   • Created By (ID): (Integer) The unique identifier of the user that created the item that starts the workflow.
   • Created By (Username): (Text) The username of the user that created the item that starts the workflow.
   • File Type: (Text) The file type of the item in the monitored list that is updated to start the workflow.
   • GUID: (Text) The Global Unique Identifier of the monitored list item.
   • ID: (Integer) The unique identifier of the created item in the monitored SharePoint on-premises list.
   • Item Attachments: (Collection) The attachment(s) included in the list item. If there are attachments, the following variables will be returned:
     • Name: Name of the attachment file(s).
     • Url: Link to the attachment file(s).
   • Item URL: (Text) The link to the newly added item in the monitored SharePoint on-premises list.
   • Modified: (DateTime) The time stamp of the item being created or edited.
   • Modified By (Display Name): (Text) The display name configured for the user who modified or created the item in the monitored SharePoint on-premises list.
   • Modified By (Email): (Text) The email address of the user who modified or created the item in the monitored SharePoint on-premises list.
   • Modified By (ID): (Integer) The unique id of the user who modified or created the item in the monitored SharePoint on-premises list.
   • Modified By (Username): (Text) The username of the user who modified or created the item in the monitored SharePoint on-premises list.
   • Title: (Text) The title of the new item created in the monitored SharePoint on-premises list.
   • Version: (Text) The version of the newly added item in the monitored SharePoint on-premises list.

   Note: These are the variables displayed for a list with the default columns available when you create a new list in SharePoint on-premises. If the list you select has additional columns there will be more start event variables displayed depending on the columns.

SharePoint on-premises - New list item start event fields and settings