msnp-wiki/docs/services/abservice/abcontactadd.md

Introduction

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

Adds a contact to the Forward List (FL). For adding a contact to 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.

ABContactAdd

This element has only one attribute:

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

abId

This element contains your Address Book Service GUID.

contacts

This element contains one or multiple <Contact> elements.

Contact

This element has only one attribute:

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

contactInfo

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

The relevant elements are:

• <passportName>: The user handle that you would like to add.
• <isMessengerUser>: Is the user I am adding a part of the Messenger Service Network? If they are, set to true, otherwise set to false.
• <contactType>: (Optional?) The type of contact you'd like to add:
  • LivePending: A Messenger Service user.
  • Regular: A user from another service.

options

This element contains one child:

• <EnableAllowListManagement>: Usually only set to true.

Server/Response

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

ABContactAddResponse

This element has only one attribute:

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

This element only contains the <ABContactAddResult> element.

ABContactAddResult

This element only contains the <guid> element.

They may be the same amount of <guid> elements as the amount of <Contact> elements you specify, but this behavour is yet to be confirmed.

guid

The GUID of the contact you have added.