# Table of contents:

• Introduction
• Client/Request
  • AddMember
    • serviceHandle
    • memberships
      • Membership
        • Members
          • Member
• Server/Response
  • AddMemberResponse
• Examples
  • Client/Request
  • Server/Response

# Introduction

AddMember is one of the SOAP actions the Contact Sharing Service provides.

Adds a user to the Allow List (AL), Block List (BL), or if the user is in the Pending List (PL), the Reverse List (RL). For adding a user to the Forward List (FL), read the ABContactAdd article.

# Client/Request

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

# AddMember

This element has only one attribute:

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

# serviceHandle

This element contains three children:

• <Id>: This is always set to 0.
• <Type>: The type of this member:
  • Messenger: This is a Messenger contact.
  • Profile: This is your profile.
• <ForeignId>: If <Type> is Profile, this should be MyProfile, otherwise leave empty but do not convert to an empty element.

# memberships

This element only contains <Membership> elements.

# Membership

This element contains two children:

• <MemberRole>: The type of list:
  • Allow: The Allow List (AL).
  • Block: The Block List (BL).
  • Reverse: The Reverse List (RL).
  • ProfileExpression: Your profile.
• <Members>: Explained below.

# Members

This element only contains <Member> elements.

# Member

This element has two attributes:

• xsi:type: The type of this <Member>:
  • PassportMember
  • EmailMember
  • PhoneMember
  • RoleMember: Only valid for ProfileExpression.
• xmlns:xsi: This is always set to http://www.w3.org/2001/XMLSchema-instance.

This element contains two children:

• <Type>: The type of this <Member>:
  • Passport
  • Email
  • Phone
• <State>: This is usually only set to Accepted, but Pending is a valid value.
• <Deleted>: Should this member be deleted? (Only set to true in UpdateMember?)

This element also contains one of the following mutually exclusive children.

1. <PassportName>: The user handle associated with this membership.
2. <Email>: The e-mail address associated with this membership.
3. <PhoneNumber>: The phone number associated with this membership, in the format of the full phone number (including country code) prefixed with a +.

This element also contains the following children IF the role is set to ProfileExpression:

• <Id>: Always Allow.
• <DefiningService>: Contains the following:
  • <Id>: Always 0.
  • <Type>: Always Messenger.
  • <ForeignId>: Always empty content, but not an empty element.
• <MaxRoleRecursionDepth>: Always 0.
• <MaxDegreesSeparationDepth>: Always 0.

# Server/Response

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

# AddMemberResponse

This empty element has only one attribute:

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

# Examples

# Client/Request

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

<?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>
                <AddMember
                        xmlns="http://www.msn.com/webservices/AddressBook"
                >
                        <serviceHandle>
                                <Id>0</Id>
                                <Id>Messenger</Id>
                                <ForeignId></ForeignId>
                        </serviceHandle>
                        <memberships>
                            <Membership>
                                <MemberRole>Allow</MemberRole>
                                <Members>
                                    <Member
                                        xsi:type="PassportMember"
                                    >
                                            <Type>Passport</Type>
                                            <State>Accepted</State>
                                            <Deleted>false</Deleted>
                                            <PassportName>anotheruser@hotmail.com</PassportName>
                                    </Member>
                                </Members>
                            </Membership>
                        </memberships>
                </AddMember>
        </soap:Body>
</soap:Envelope>

# Server/Response

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

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