# AddItem

**EventNames:**

- AddItem_Restrictions
- AddItem_Pre
- AddItem_Post

**Parameters**

| Type                                                 | Name       | Description                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Item](<inv:powervault#code_reference/objects/item>) | item       | The item which should get / is added.<br><br>**Restrictions and Pre:** <br>In *Restrictions* and *Pre* you have very limited data, because the item does not exist so far.<br>Only the property `_NewCategoryName` is set as long as a valid category Id was passed.<br><br>**Post:**<br>In *POST* you have a full powerVaultItem object available, because at this point the item exists. |
| bool                                                 | successful | **Post**:<br>The information whether the Web Service call was successful or not is only available in *Post* events.                                                                                                                                                                                                                                                                        |

:::{admonition} Unexpected Behaviour
:class: warning

**AddItem event** is raised when clicking in Vault Client on *New Item... -> Selecting Category -> Ok*.<br>
Therefore you have *only* the data about the selected Category available and seriously not more.
:::

**Examples:**\
AddItem_Restrictions:

```powershell
Register-VaultEvent -EventName AddItem_Restrictions -Action 'RestrictAddItem'

function RestrictAddItem($item) {
	#Write event code here
}
```

AddItem_Pre:

```powershell
Register-VaultEvent -EventName AddItem_Pre -Action 'PreAddItem'

function PreAddItem($item) {
	#Write event code here
}
```

AddItem_Post:

```powershell
Register-VaultEvent -EventName AddItem_Post -Action 'PostAddItem'

function PostAddItem($item, $successful) {
	#Write event code here
}
```