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 Add List Item action configuration on the current site
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 |