56 lines
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
|
# Introduction
|
||
|
|
`ABContactAdd` is one of the SOAP actions the [Address Book Service](../abservice.md) provides.
|
||
|
|
|
||
|
|
Adds a contact to the Forward List (FL).
|
||
|
|
For adding a contact to any other list, see the [Contact Sharing Service](../sharingservice.md).
|
||
|
|
|
||
|
|
# Client/Request
|
||
|
|
The template used in this action is described on the [Address Book Service](../abservice.md) 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](../abservice.md) GUID.
|
||
|
|
|
||
|
|
### contacts
|
||
|
|
This element contains one or multiple [`<Contact>`](#contact-elements) 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>`](contactinfo.md) 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](../abservice.md) 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.
|