# Table of contents:

• Introduction
• Client/Request
  • ABContactUpdate
    • abId
    • contacts
      • Contact
        • contactId
        • contactInfo
        • propertiesChanged
• Server/Response
  • ABContactUpdateResponse
• Examples
  • Client/Request
  • Server/Response

# Introduction

ABContactUpdate is one of the SOAP actions the Address Book Service provides.

Modifies information about one or more contact(s) in an Address Book.

In Official Client terms, this will modify contacts in your Forward List (FL). For modifying a contact's information from any other list, see the Contact Sharing Service.

# Client/Request

The template used in this action is described on the Address Book Service main page.

# ABContactUpdate

This element has only one attribute:

• xmlns: This is always set to http://www.msn.com/webservices/AddressBook.

# abId

This element contains the Address Book GUID to use.

# contacts

This element contains one or more <Contact> elements.

# Contact

This element has only one attribute:

• xmlns: This is always set to http://www.msn.com/webservices/AddressBook.

# contactId

This element only contains the GUID of the contact you would like to modify.

# contactInfo

For more information about this element, read the <contactInfo> article.

The most relevant children are:

• <displayName>: The new display name for this contact.
• <isMessengerUser>: If this is set to false, this user is to be treated as a e-mail contact instead of an Instant Messaging Contact.

# propertiesChanged

This element only contains the space delimited list of updated items in <contactInfo>. The valid values are the following:

• DisplayName
• Passport
• IsMessengerUser
• ContactFirstName
• ContactLastName
• Comment
• MiddleName
• ContactPrimaryEmailType
• ContactEmail
• ContactLocation
• ContactPhone
• ContactWebSite
• Annotation

# Server/Response

The template used in this action is described on the Address Book Service main page.

# ABContactUpdateResponse

This empty element has only one attribute:

• xmlns: This is always set to http://www.msn.com/webservices/AddressBook.

# Examples

# Client/Request

POST /abservice/abservice.asmx HTTP/1.1
SOAPAction: http://www.msn.com/webservices/AddressBook/ABContactUpdate
Cache-Control: no-cache
Content-Type: text/xml; charset=utf-8
Content-Length: 1248

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
	xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
>
	<soap:Header>
		<ABApplicationHeader xmlns="http://www.msn.com/webservices/AddressBook">
			<ApplicationID>996CDE1E-AA53-4477-B943-2BE802EA6166</ApplicationID>
			<IsMigration>false</IsMigration>
			<PartnerScenario>Timer</PartnerScenario>
		</ABApplicationHeader>
		<ABAuthHeader xmlns="http://www.msn.com/webservices/AddressBook">
			<ManagedGroupRequest>false</ManagedGroupRequest>
			<TicketToken>t=ticket&amp;p=profile</TicketToken>
		</ABAuthHeader>
	</soap:Header>
	<soap:Body>
		<ABContactUpdate xmlns="http://www.msn.com/webservices/AddressBook">
			<abId>00000000-0000-0000-0000-000000000000</abId>
			<contacts>
				<Contact xmlns="http://www.msn.com/webservices/AddressBook">
					<contactId>c1f9a363-4ee9-4a33-a434-b056a4c55b98</contactId>
					<contactInfo>
						<displayName>another user</displayName>
					</contactInfo>
					<propertiesChanged>DisplayName <propertiesChanged>
				</Contact>
			</contacts>
		</ABContactUpdate>
	</soap:Body>
</soap:Envelope>

# Server/Response

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: 725

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
	xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
>
	<soap:Header>
		<ServiceHeader xmlns="http://www.msn.com/webservices/AddressBook">
			<Version>12.01.1111.0000</Version>
			<CacheKey>12r1;MjAyNC0xMS0xOVQxNzo0Nzo1OS4zMDZa</CacheKey>
			<CacheKeyChanged>true</CacheKeyChanged>
			<PreferredHostName>contacts.example.com</PreferredHostName>
			<SessionId>ecfaf8c7-e388-4571-8641-b061a0ac4bdc</SessionId>
		</ServiceHeader>
	</soap:Header>
	<soap:Body>
		<ABContactUpdateResponse xmlns="http://www.msn.com/webservices/AddressBook" />
	</soap:Body>
</soap:Envelope>