SharePoint Online - Create an item

Use the SharePoint Online - Create an item actionA tool for building the processes, logic, and direction within workflows. to create an item with the specified fields in a list in SharePoint Online.

Before you start 

Configure the SharePoint Online - Create an item action

The steps required to configure the action are given below. The SharePoint Online - Create an item action fields and settings table describes all the required and optional configuration fields.

Important: Before inserting variables in the action configuration, you must manually type or select the values and populate other dependent fields in order to retrieve the output data. Once configured, you can insert variables to the required fields.

  1. Select a Connection.
  2. Note: 

    Only the connections created with the List and libraries authentication method are available in the drop-down list.

    For more information about authentication methods for SharePoint Online connections, see Connectors.

  1. Type a SharePoint site URL and click Retrieve lists.
  2. Example: https://domain.sharepoint.com/sites/hr

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

  1. In List name, select the list you want to create the item in. The Add field button is enabled to enter values for the columns/fields of the created item. If the selected list has mandatory columns they are displayed by default to enter a value.
  2. Specify values for the mandatory fields/columns that are displayed.

SharePoint Online - Create an item action fields and settings

Important: Before inserting variables in the action configuration, you must manually type or select the values and populate other dependent fields in order to retrieve the output data. Once configured, you can insert variables to the required fields.

Section Field Description Variable types
(unlabeled)

ConnectionCredentials and other settings required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store.

SharePoint Online connection to connect to the SharePoint Online site.

To refresh the available connections, click Refresh.

(n/a)
New item

SharePoint site URL

The URL of the SharePoint Online site that has the list or document library you want to use.

To retrieve the lists for the SharePoint site URL, type the SharePoint site URL and click Retrieve lists.

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

Text, Decimal, Integer, Boolean, DateTime, Collection

 

List name

The list in which you want to create the item.

The lists and document libraries within the site specified in SharePoint site URL are displayed in the drop-down list.

When a List name is selected the Add fields button is displayed to select fields for the item you are creating.

Text, Decimal, Integer, Boolean, DateTime, Collection

 

Folder path

The destination folder to create the item in.

If a folder path is not specified, the item is created at the root level of the list.

Boolean, Collection, DateTime, Decimal, Integer, Text

  Add fields

(Displayed only when a List name is selected.)

Displays selections to select and add columns (fields) that you want to populate for the item.

The fields you add are displayed for you to enter the value. The item is created in the list with these values populated in the columns.

The values you enter must meet SharePoint Online formatting requirements for the related column type. See, Valid values for added fields, by column type.

varies
Output

Result

Stores the result of the action in an object with the following variables:

  • Item ID: Integer variable to store the ID of the created item.
  • Item GUID: Text variable to store the GUID of the created item.
  • Item URL: Text variable to store the URL of the created item.

ObjectA variable that groups several related variables of any type into a hierarchical structure. Objects can contain other Objects.