Edit

CreateItem

  • Article

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
https://schemas.microsoft.com/exchange/services/2006/messages
Schema Name
Messages schema
Validation File
Messages.xsd
Can be Empty
False

See also