CreateItem (E-mail Message)
Last modified: March 16, 2009
Applies to: Exchange Server 2007 | Exchange Server 2010
In this article
CreateItem Request Example
Successful CreateItem Response
Error CreateItem Response
The CreateItem operation is used to create e-mail messages.
CreateItem Request Example
Description
The following example of a CreateItem request shows how to create a new e-mail message, send the message, and save a copy of it in the drafts folder.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<CreateItem MessageDisposition="SendAndSaveCopy" xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<SavedItemFolderId>
<t:DistinguishedFolderId Id="drafts" />
</SavedItemFolderId>
<Items>
<t:Message>
<t:ItemClass>IPM.Note</t:ItemClass>
<t:Subject>Project Action</t:Subject>
<t:Body BodyType="Text">Priority - Update specification</t:Body>
<t:ToRecipients>
<t:Mailbox>
<t:EmailAddress>sschmidt@example.com</t:EmailAddress>
</t:Mailbox>
</t:ToRecipients>
<t:IsRead>false</t:IsRead>
</t:Message>
</Items>
</CreateItem>
</soap:Body>
</soap:Envelope>
Request Elements
The following elements are used in the request:
To find other options for the request message of the CreateItem operation, explore the schema hierarchy. Start at the CreateItem element.
Successful CreateItem Response
Description
The following example shows a successful response to the CreateItem request.
Code
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="595" MinorBuildNumber="0" xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<CreateItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:CreateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items />
</m:CreateItemResponseMessage>
</m:ResponseMessages>
</CreateItemResponse>
</soap:Body>
</soap:Envelope>
Successful Response Elements
The following elements are included in the response:
To find other options for the response message of the CreateItem operation, explore the schema hierarchy. Start at the CreateItemResponse element.
Error CreateItem Response
Description
The following example shows an error response to a CreateItem request.
Code
[xml]
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="595" MinorBuildNumber="0" xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<CreateItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:CreateItemResponseMessage ResponseClass="Error">
<m:MessageText>The user account which was used to submit this request does not have the right to send mail on behalf of the specified sending account.</m:MessageText>
<m:ResponseCode>ErrorSendAsDenied</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:Items />
</m:CreateItemResponseMessage>
</m:ResponseMessages>
</CreateItemResponse>
</soap:Body>
</soap:Envelope>
Error Response Elements
The following elements are used in the error response:
To find other options for the error response message of the CreateItem operation, explore the schema hierarchy. Start at the CreateItemResponse element.