# Table of contents:

• Introduction
• Client/Request
  • ABUpdate
    • ab
      • abInfo
• Server/Response
  • ABUpdateResponse
• Examples
  • Client/Request
  • Server/Response

# Introduction

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

Update an Address Book.

# Client/Request

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

# ABUpdate

This element has only one attribute:

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

This element contains only one child:

• <ab>: Described below.

# ab

This element contains six children:

• <abId>: The Address Book GUID to modify.
• <abInfo>: Described below.
• <lastChange>: The ISO 8601 timestamp of the time a change was last made to this Address Book.
• <DynamicItemLastChanged>: The ISO 8601 timestamp of the time any dynamic item was last modified.
• <createDate>: The ISO 8601 timestamp of the time this Address Book was created.
• <propertiesChanged>: Contains a space delimited list of changed elements:
  • Name
  • IsBot

# abInfo

This element contains seven children:

• <name>: The given name of the Address Book.
• <ownerPuid>: The Address Book owner's PUID, as a signed 64-bit integer.
• <OwnerCID>: Your Common ID, an signed 64-bit integer.
• <ownerEmail>: Your user handle.
• <fDefault>: Is this the default Address Book? (true or false)
• <joinedNamespace>: unknown (true or false)
• <IsBot>: Is this account provisioned? (true or false)

# Server/Response

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

# ABUpdateResponse

This 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/ABUpdate
Cache-Control: no-cache
Content-Type: text/xml; charset=utf-8
Content-Length: 1477

<?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>AAD9B99B-58E6-4F23-B975-D9EC1F9EC24A</ApplicationId>
			<IsMigration>false</IsMigration>
			<PartnerScenario>Initial</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>
		<ABUpdate xmlns="http://www.msn.com/webservices/AddressBook">
			<ab>
				<abId>00000000-0000-0000-0000-000000000000</abId>
				<abInfo>
					<name>My Address Book</name>
					<ownerPuid>4294967298</ownerPuid>
					<OwnerCID>4294967298</OwnerCID>
					<ownerEmail>example@hotmail.com</ownerEmail>
					<fDefault>true</fDefault>
					<joinedNamespace>false</joinedNamespace>
					<IsBot>false</IsBot>
				</abInfo>
				<lastChange>2026-10-17T19:51:00.4000000-08:00</lastChange>
				<DynamicItemLastChanged>0001-01-01T00:00:00</DynamicItemLastChanged>
				<createDate>2024-10-10T20:38:51.0000000-08:00</createDate>
				<propertiesChanged>Name </propertiesChanged>
			</ab>
		</ABUpdate>
	</soap:Body>
</soap:Envelope>

# Server/Response

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

<?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;MjAyNi0wMi0wOFQxODoxMzozNS41MTFa</CacheKey>
			<CacheKeyChanged>true</CacheKeyChanged>
			<PreferredHostName>contacts.example.com</PreferredHostName>
			<SessionId>ecfaf8c7-e388-4571-8641-b061a0ac4bdc</SessionId>
		</ServiceHeader>
	</soap:Header>
	<soap:Body>
		<ABUpdateResponse xmlns="http://www.msn.com/webservices/AddressBook" />
	</soap:Body>
</soap:Envelope>