3.1.4.2 CreateItem Operation

The CreateItem operation creates Post objects on the server. This operation is specified in [MS-OXWSCORE] section 3.1.4.2.

The following is the WSDL port type specification for the CreateItem operation.

 <wsdl:operation name="CreateItem">
      <wsdl:input message="tns:CreateItemSoapIn" />
      <wsdl:output message="tns:CreateItemSoapOut" />
 </wsdl:operation>

The following is the WSDL binding specification for the CreateItem operation.

 <wsdl:operation name="CreateItem">
    <soap:operation soapAction="http://schemas.microsoft.com/exchange/services/2006/messages/CreateItem"/>
    <wsdl:input>
       <soap:header message="tns:CreateItemSoapIn" part="Impersonation" use="literal"/>
       <soap:header message="tns:CreateItemSoapIn" part="MailboxCulture" use="literal"/>
       <soap:header message="tns:CreateItemSoapIn" part="RequestVersion" use="literal"/>
       <soap:header message="tns:CreateItemSoapIn" part="TimeZoneContext" use="literal"/>
       <soap:body parts="request" use="literal"/>
    </wsdl:input>
    <wsdl:output>
       <soap:body parts="CreateItemResult" use="literal"/>
       <soap:header message="tns:CreateItemSoapOut" part="ServerVersion" use="literal"/>
    </wsdl:output>
 </wsdl:operation>

The following table summarizes the set of WSDL message definitions that are specific to the CreateItem operation.

Message name

Description

CreateItemSoapIn

The CreateItemSoapIn message is specified in [MS-OXWSCORE] section 3.1.4.1.1.1. It specifies the CreateItem operation request to create one or more Post objects on the server.

The Items child element ([MS-OXWSCDATA] section 2.2.4.46) of the CreateItem element ([MS-OXWSCORE] section 3.1.4.2.2.1) that specifies the XML request MUST contain one or more PostItem elements ([MS-OXWSCDATA] section 2.2.4.46) or PostReplyItem elements ([MS-OXWSCDATA] section 2.2.4.46).

The post item MUST NOT be created in the following folders: Calendar folder, Contacts folder, Tasks folder, Notes folder, Journal folder, Search folder, and Outlook Search folder. Otherwise, the server MUST return an ErrorCannotCreatePostItemInNonMailFolder response code, as specified in [MS-OXWSCDATA] section 2.2.5.23.

1. CreateItemSoapOut

The CreateItemSoapOut message is specified in[MS-OXWSCORE] section 3.1.4.2.1.2. It specifies the server response to the CreateItem operation request.

In the response message, the Items element ([MS-OXWSCDATA] section 2.2.4.41) contains one or more PostItem elements ([MS-OXWSCDATA] section 2.2.4.10).

The client sends a tns:CreateItemSoapIn request WSDL message and the server MUST respond with a tns:CreateItemSoapOut response WSDL message.