3.1.4.2 AddImContactToGroup

The AddImContactToGroup WSDL operation adds an existing contact (2) to an instant messaging group.

The following is the WSDL port type specification of the AddImContactToGroup WSDL operation.

 <wsdl:operation name="AddImContactToGroup" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input message="tns:AddImContactToGroupSoapIn"/>
   <wsdl:output message="tns:AddImContactToGroupSoapOut"/>
 </wsdl:operation>

The following is the WSDL binding specification of the AddImContactToGroup WSDL operation.

 <wsdl:operation name="AddImContactToGroup" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <soap:operation soapAction="http://schemas.microsoft.com/exchange/services/2006/messages/AddImContactToGroup" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
   <wsdl:input>
     <soap:header message="tns:AddImContactToGroupSoapIn" part="Impersonation" use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
     <soap:header message="tns:AddImContactToGroupSoapIn" part="MailboxCulture" use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
     <soap:header message="tns:AddImContactToGroupSoapIn" part="RequestVersion" use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
     <soap:body use="literal" parts="request" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
   </wsdl:input>
   <wsdl:output>
     <soap:body use="literal" parts="AddImContactToGroupResult" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
     <soap:header message="tns:AddImContactToGroupSoapOut" part="ServerVersion" use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
   </wsdl:output>
 </wsdl:operation>

This operation accepts only existing contacts. The AddNewImContactToGroup (section 3.1.4.4) or the AddNewTelUriContactToGroup (section 3.1.4.5) operation can be used to add a new instant messaging contact (2) to the Unified Contact Store.

The protocol client sends an AddImContactToGroupSoapIn request WSDL message and the protocol server responds with an AddImContactToGroupSoapOut response WSDL message.