# AddChangeOrder **EventNames:** - AddChangeOrder_Restrictions - AddChangeOrder_Pre - AddChangeOrder_Post **Parameters** | Type | Name | Description | | ------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [ChangeOrder]() | changeOrder | The changeOrder which should get / is added.

**Restrictions and Pre:**
In *Restrictions* and *Pre* you have the all the properties available on the object like `_NewNumber`, `_NewTitle(Item,CO)`, `_NewDescription(Item,CO)`, `_NewApproveDeadline` and `NewRouting`.

**Post:**
In *POST* you have the full powerVaultChangeOrder object, because at this point the Change Order exists. | | [File[]]() | files | The Files to be tracked by the Change Order. | | [Item[]]() | items | The Items to be tracked by the Change Order.
*User Defined Link properties* are added and removed directly on the items. | | [File[]]() | attachments | Files to be attached to the Change Order. | | [Comment[]]() | comments | Multiple comments for the ChangeOrder including there attached files. | | [Email[]]() | emails | Multiple emails to send out upon completion. | | bool | successful | **Post**:
The information whether the Web Service call was successful or not is only available in *Post* events. | :::{admonition} Unexpected Behaviour :class: warning **AddChangeOrder event** is raised when clicking in Vault Client on *New Change Order... -> Save*.\ Afterwards it fires **EditChangeOrder**.\ *No CommitChangeOrder is called.* The argument **files** contains only the files that are directly linked to the ChangeOrder, and not the primary-links of the linked Items! The argument **comments** contains the newly added comments.\ A negative Id value is returned in Pre events and even the values for all other properties except `Subject (CO)`, `Message` and `Attachments` can only be retrieved in in Post events. ::: **Examples:**\ AddChangeOrder_Restrictions: ```powershell Register-VaultEvent -EventName AddChangeOrder_Restrictions -Action 'RestrictAddChangeOrder' function RestrictAddChangeOrder($changeOrder, $files, $items, $attachments, $comments, $emails) { #Write event code here } ``` AddChangeOrder_Pre: ```powershell Register-VaultEvent -EventName AddChangeOrder_Pre -Action 'PreAddChangeOrder' function PreAddChangeOrder($changeOrder, $files, $items, $attachments, $comments, $emails) { #Write event code here } ``` AddChangeOrder_Post: ```powershell Register-VaultEvent -EventName AddChangeOrder_Post -Action 'PostAddChangeOrder' function PostAddChangeOrder($changeOrder, $files, $items, $attachments, $comments, $emails, $successful) { #Write event code here } ```