# 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.