Action: Add list item

Add list item action allows adding a new list item dynamically to a specified SharePoint list. When the Add list item action is executed, the new item is added immediately setting the configured field values.

Example of action configuration

For more information about Action Builder read Action Builder introduction article.

To configure the action Add list item additional properties should be specified:

Configuration

*Property*	*Required*	*Type*	*Description*
List	yes	Choice	A list where the new item should be added. It is possible to select the list: - from the current site, by selecting the 'On current site' option. The drop-down shows all available lists on the site. - from any site, by selecting 'On any site' option, choosing the site in the drop-down or typing a server relative URL to the site and then selecting a list in 'List' drop-down NOTE: You cannot add an item to a library.
Use dynamic url to the target SharePoint list	no	Choice	Available when using option 'On any site'. Allows you to dynamically set the target list URL
Dynamic list url	yes	String	Specify the target list URL (expression enabled value). The item will be added to this list
Folder	no	String	You can specify the list-relative URL to the folder where the new item should be added. NOTE: Action does not create a folder, the folder should already exist.
Content Type	yes	Choice	Allows choosing the content type of the item to be added. Depending on the content type, all relevant fields are displayed at the bottom, so that for every field the value to be set can be configured.
Field Name	depends on field setting		You can enter the value or set the value using placeholders available in the Expression Builder.

Availability

*Modern Forms*	*List Actions*	*Scheduled/Triggered Actions*
✓	✓	✓*

* In Scheduled/Triggered actions only adding item on the list from the current site is available.

Output

*Output Parameter*	*Type*	*Description*
ItemID	Number	Returns the Id of the added item as output parameter and can be used in subsequent actions.
ItemLink	String	Returns the full URL to the display form of the added item