CreateItem

Last modified: March 16, 2009

Applies to: Exchange Server 2007 | Exchange Server 2010

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.

NoteNote
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.

NoteNote
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 (CreateItem)

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

Namespace

https://schemas.microsoft.com/exchange/services/2006/messages

Schema Name

Messages schema

Validation File

Messages.xsd

Can be Empty

False