Creating a contact by using XML

Use the CreateContact procedure of the Managed Active Directory namespace to create a contact in Active Directory.

This procedure expects to be called with impersonate="1". The procedure impersonates the caller.

Example of a request that calls the CreateContact procedure

<request>
   <procedure>
	 <execute namespace="Managed Active Directory" procedure="CreateContact">
	 <executeData>
		 <container>LDAP://OU=Hosting,DC=contoso,DC=com</container>
		 <name>Kevin Browne</name>
		 <properties>
		 <property name="displayName">Kevin F. Browne</property>
		 <property name="givenName">Kevin</property>
		 <property name="middleName">F</property>
		 <property name="sn">Browne</property>
		 <property name="initials">KFB</property>
		 <property name="description">description of new contact</property>
		 </properties>
	 </executeData>
	 <after source="executeData" sourcePath="path"
		 destination="data"mode="insert" /> 
	 </execute>
  </procedure>
</request>

Input for CreateContact

The following input is valid for this request:

• Container LDAP path

  Use the <container> element to specify the container Lightweight Directory Access Protocol (LDAP) path where you want to add the contact.

  <container>LDAP://LDAP path of the container</container>
  

• Name of the contact

  Use the <name> element to specify the name of the contact.

  <name>My new contact</name>
  

• Properties (optional)

  By using the <properties> element, you can add any properties that you want to store with the contact. This information is optional.

  <properties>
     <property name="displayName">Name to display</property>
     <property name="givenName">Contact's first name</property>
     <property name="middleName">Contact's middle name</property>
     <property name="sn">Contact's last name</property>
     <property name="initials">Contact's initials</property>
     <property name="description">Description</property>
  </properties>
  

Typical response for CreateContact

<response>
  <data>
	<path>LDAP://cn=Kevin Browne,OU=Hosting,DC=contoso,DC=com</path>
  </data>
</response>

Important

• Although Active Directory is not case sensitive for elements such as the Lightweight Directory Access Protocol (LDAP) path, XML is case sensitive. To ensure that the procedure executes appropriately, specify all tags, elements, and data using uppercase and lowercase letters exactly as shown in the XML examples. For additional guidelines on how to use XML, see the Microsoft Web site (http://www.microsoft.com/).