CreateItem
The CreateItem element defines a request to create an item in the Exchange store.
<CreateItem MessageDisposition="" SendMeetingInvitations="">
<SavedItemFolderId/>
<Items/>
</CreateItem>
CreateItemType
Attributes and elements
The following sections describe attributes, child elements, and parent elements.
Attributes
| Attribute | Description |
|---|---|
| MessageDisposition |
Describes how the item will be handled after it is created. The attribute is required for e-mail messages. This attribute is only applicable to e-mail messages. |
| SendMeetingInvitations |
Describes how meeting requests are handled after they are created. This attribute is required for calendar items. |
MessageDisposition Attribute
| Value | Description |
|---|---|
| SaveOnly |
The message item is saved in the folder that is specified by the SavedItemFolderId element. Messages can be sent later by using the SendItem operation. An item identifier is returned in the response. Item identifiers are not returned for any item types except for message items. This includes response objects. |
| SendOnly |
The item is sent but no copy is saved in the Sent Items folder. An item identifier is not returned in the response. NOTE: CreateItem does not support delegate access when the SendOnly option is used because a destination folder cannot be specified with this option. The workaround is to create the item, get the item identifier, and then use the SendItem operation to send the item. |
| SendAndSaveCopy |
The item is sent and a copy is saved in the folder that is identified by the SavedItemFolderId element. An item identifier is not returned in the response. NOTE: Meeting requests are not saved to the folder that is identified by the SavedItemFolderId property. For calendaring, only the save location for calendar items can be specified by the SavedItemFolderId property. You cannot control where a meeting request item is saved. Only the associated calendar items are copied and saved into the folder that is identified by the SavedItemFolderId property. |
SendMeetingInvitations Attribute
| Value | Description |
|---|---|
| SendToNone |
If the item is a meeting request, it is saved as a calendar item but not sent. |
| SendOnlyToAll |
The meeting request is sent to all attendees but is not saved in the Sent Items folder. |
| SendToAllAndSaveCopy |
The meeting request is sent to all attendees and a copy is saved in the folder that is identified by the SavedItemFolderId element. |
Child elements
| Element | Description |
|---|---|
| SavedItemFolderId |
Identifies the target folder where a new item can be created. If the MessageDisposition attribute is set to SendOnly, a created message will only be sent. The message will not be put in the folder that is identified by the SavedItemFolderId element. |
| Items (NonEmptyArrayOfAllItemsType) |
Contains an array of items to create in the folder that is identified by the SavedItemFolderId element. |
Parent elements
None.
Remarks
The schema that describes this element is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.
Element information
| Element | Example |
|---|---|
| Namespace |
http://schemas.microsoft.com/exchange/services/2006/messages |
| Schema Name |
Messages schema |
| Validation File |
Messages.xsd |
| Can be Empty |
False |