# Create new item, with field values

Creates a new item in a Custom List app. Returns the ID of created item in Results.

#### Parameters <a href="#parameters" id="parameters"></a>

| Parameter            | Description                                                                                                                                                                            |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Custom List app name | Name of Custom List app in SharePoint (not id)                                                                                                                                         |
| Item name            | Title of new item                                                                                                                                                                      |
| Field values         | Table consisting of field values. Note that StaticName of fields needs to be provided, not Title                                                                                       |
| Folder url           | Url to folder to create item in. Leave empty for root folder. Example if adding item to folder 'folder1' in Custom List 'clist' in subsite 'subsite1': '/subsite1/Lists/clist/folder1' |

#### Output <a href="#output" id="output"></a>

Record with information about whether operation failed or not.

| Member       | Description                                         |
| ------------ | --------------------------------------------------- |
| HasFailed    | Whether operation has failed or not                 |
| ErrorMessage | A description of the failure, if any                |
| Results      | Simple variable containing the results of operation |

#### Errors <a href="#errors" id="errors"></a>

| Error code | Description                                  |
| ---------- | -------------------------------------------- |
| 1000       | Unspecified error.                           |
| 1000001    | User is not authorized to perform operation. |