CreateAttachment Operation
Last modified: March 16, 2009
Applies to: Exchange Server 2007 | Exchange Server 2010
In this article
File CreateAttachment Request Example
Successful File CreateAttachment Response Example
Item CreateAttachment Request Example
Successful Item CreateAttachment Response Example
CreateAttachment Error Response Example
The CreateAttachment operation creates either an item or file attachment and attaches it to the specified item.
File CreateAttachment Request Example
Description
The following example of a CreateAttachment request shows how to create a file attachment.
Code
<?xml version="1.0" encoding="utf-8"?>
<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>
<CreateAttachment xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<ParentItemId Id="AAAtAE..." ChangeKey="CQAAABYA..."/>
<Attachments>
<t:FileAttachment>
<t:Name>SomeFile</t:Name>
<t:Content>AQIDBAU=</t:Content>
</t:FileAttachment>
</Attachments>
</CreateAttachment>
</soap:Body>
</soap:Envelope>
Comment
A name for the attachment must be provided.
Note
The parent item identifier and change key have been shortened to preserve readability.
Request Elements
The following elements are used in the request:
Successful File CreateAttachment Response Example
Description
The following example shows a successful response to the CreateAttachment 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="653" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateAttachmentResponse 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:CreateAttachmentResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Attachments>
<t:FileAttachment>
<t:AttachmentId Id="AAAtAE=" RootItemId="AAAtAEFk=" RootItemChangeKey="CQAAAB"/>
</t:FileAttachment>
</m:Attachments>
</m:CreateAttachmentResponseMessage>
</m:ResponseMessages>
</CreateAttachmentResponse>
</soap:Body>
</soap:Envelope>
Comment
The response contains the identifier of the attached file. It also contains the identifier and change key of the root item. The item identifiers and change key have been shortened to preserve readability.
Successful Response Elements
The following elements are used in the response:
Item CreateAttachment Request Example
Description
The following example of a CreateAttachment request shows how to create an item attachment.
Code
<?xml version="1.0" encoding="utf-8"?>
<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>
<CreateAttachment xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<ParentItemId Id="AAAtAE=" ChangeKey="CQAAABYA"/>
<Attachments>
<t:ItemAttachment>
<t:Name>An item attachment</t:Name>
<t:Message>
<t:Subject>A message to attach</t:Subject>
</t:Message>
</t:ItemAttachment>
</Attachments>
</CreateAttachment>
</soap:Body>
</soap:Envelope>
Comment
A name for the attachment must be provided.
Note The parent item identifier and change key have been shortened to preserve readability.
Request Elements
The following elements are used in the request:
Successful Item CreateAttachment Response Example
Description
The following example shows a successful response to the CreateAttachment 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="653" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateAttachmentResponse 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:CreateAttachmentResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Attachments>
<t:ItemAttachment>
<t:AttachmentId Id="AAAtAEFk=" RootItemId="AAAtAEFkb=" RootItemChangeKey="CQAAABYA"/>
</t:ItemAttachment>
</m:Attachments>
</m:CreateAttachmentResponseMessage>
</m:ResponseMessages>
</CreateAttachmentResponse>
</soap:Body>
</soap:Envelope>
Comment
The response contains the identifier of the new attachment. It also contains the identifier and change key of the root item. The root item is the item that contains the attachment. The item identifiers and change key have been shortened to preserve readability.
Successful Response Elements
The following elements are used in the response:
CreateAttachment Error Response Example
Description
The following example shows an error response to the CreateAttachment request. The error is due to the fact that the name of the attachment was not specified.
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="653" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
</soap:Header>
<soap:Body>
<CreateAttachmentResponse 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:CreateAttachmentResponseMessage ResponseClass="Error">
<m:MessageText>Required property is missing.</m:MessageText>
<m:ResponseCode>ErrorRequiredPropertyMissing</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:MessageXml>
<t:ExceptionFieldURI FieldURI="attachment:Name"/>
</m:MessageXml>
<m:Attachments/>
</m:CreateAttachmentResponseMessage>
</m:ResponseMessages>
</CreateAttachmentResponse>
</soap:Body>
</soap:Envelope>
Error Response Elements
The following elements are used in the error response:
Remarks
If multiple attachments are attached to an item in a single round trip, the RootItemChangeKey in the last response message is the one that represents the new change key of the item that has the attachments.