SendItem Operation
Last modified: May 15, 2009
Applies to: Exchange Server 2007 | Exchange Server 2010
In this article
SendItem (E-mail Message) Request Example
Successful SendItem (E-mail Message) Response
Invalid SendItem (E-mail Message) Request Example
SendItem (E-mail Message) Error Response
The SendItem operation is used to send e-mail messages that are located in the Exchange store.
SendItem (E-mail Message) Request Example
Description
The following example shows how to send an e-mail message.
Code
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<SendItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
SaveItemToFolder="true">
<ItemIds>
<t:ItemId Id="AAAtAEF=" ChangeKey="CQAAABY+T" />
</ItemIds>
</SendItem>
</soap:Body>
</soap:Envelope>
Comments
The item identifier has been shortened to preserve readability.
Request Elements
Successful SendItem (E-mail Message) Response
Description
The following example shows a successful SendItem response.
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="602" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<SendItemResponse 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:SendItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
</m:SendItemResponseMessage>
</m:ResponseMessages>
</SendItemResponse>
</soap:Body>
</soap:Envelope>
Successful Response Elements
The following elements are used in the response:
Comments
A delegate who tries to send an e-mail message that is located in the principal's Drafts folder with the SendAndSaveCopy option set to save a copy in the Sent Items distinguished folder will silently fail to move a copy of the sent item to the Sent Items distinguished folder. The item will remain in the principal's Drafts folder. The workaround for this issue is to specify the principal's mailbox in the DistinguishedFolderId element.
An additional scenario to consider is when a delegate creates an e-mail message and saves it to the Drafts folder of the delegate's mailbox. If the delegate tries to send the item and save a copy to the principal's Sent Items distinguished folder, the message is sent correctly, the draft message remains in the delegate's Drafts folder, the sent message does not appear in either the delegate's or principal's Sent Items folder, and the response is a success.
Invalid SendItem (E-mail Message) Request Example
Description
The following code sample shows an example of a request with an invalid identifier.
Code
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<SendItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
SaveItemToFolder="true">
<ItemIds>
<t:ItemId Id="%BadItemId%" ChangeKey="CQAAABYAAA" />
</ItemIds>
</SendItem>
</soap:Body>
</soap:Envelope>
SendItem (E-mail Message) Error Response
Description
The following example shows an error response to a SendItem request that contains an invalid identifier.
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="602" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<SendItemResponse 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:SendItemResponseMessage ResponseClass="Error">
<m:MessageText>Id is malformed.</m:MessageText>
<m:ResponseCode>ErrorInvalidIdMalformed</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:SendItemResponseMessage>
</m:ResponseMessages>
</SendItemResponse>
</soap:Body>
</soap:Envelope>
Error Response Elements
The following elements are used in the error response:
See Also