SharePoint Online - New list item

Use the SharePoint - 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 Online list. For more information on SharePoint Online and its other start events and actions, see SharePoint Online.

Select the SharePoint - 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 Online.

   The Event field is displayed.

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

   The Configuration section is displayed to configure the start event.

Configure the SharePoint - New list item start event

Important: If the SharePoint Online list has a multi-value enabled column of Person type with a user that doesn't have the email address configured, only the user ID is returned for that column. All other Person columns in that list are also impacted and only the user ID is returned for all Person columns.

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

   Note: Only the connections created with the List and libraries authentication method are available in the Connection drop-down list. For more information about authentication methods for SharePoint Online connections, see Authentication methods for SharePoint Online connections.

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 - 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 Online 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 Online 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 Online list.
   • Modified By (Email): (Text) The email address of the user who modified or created the item in the monitored SharePoint Online list.
   • Modified By (ID): (Integer) The unique id of the user who modified or created the item in the monitored SharePoint Online list.
   • Modified By (Username): (Text) The username of the user who modified or created the item in the monitored SharePoint Online list.
   • Title: (Text) The title of the new item created in the monitored SharePoint Online list.
   • Version: (Text) The version of the newly added item in the monitored SharePoint Online list.

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

SharePoint - New list item start event fields and settings