# Introduction
`ABGroupAdd` is one of the SOAP actions the [Address Book Service](../abservice.md) provides.

Creates a contact group.

# Client/Request
The template used in this action is described on the [Address Book Service](../abservice.md) main page.

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

### groupAddOptions
This element has only one child:
* `<fRenameOnMsgrConflict>`: Should this group be renamed if it conflicts with
  a group that already exists in the Messenger Service (`true` or `false`)?

### groupInfo
This element only contains the `<GroupInfo>` element.

#### GroupInfo
This element contains four children:
* `<name>`: The name of the group.
* `<groupType>`: The GUID type of group:
    * `C8529CE2-6EAD-434d-881F-341E17DB3FF8`: A contact group.
* `<fMessenger>`: Unknown purpose (`true` or `false`).

##### annotations
This element only contains one or multiple `<Annotation>` element(s).

###### Annotation
This element only has two children:
* `<Name>`: The key of this annotation.
* `<Value>`: The value of this annotation.

Usually only used to set `MSN.IM.Display` to `1`.

# Server/Response
The template used in this action is described on the [Address Book Service](../abservice.md) main page.

## ABGroupAddResponse
This element has only one attribute:
* `xmlns:` Is always set to `http://www.msn.com/webservices/AddressBook`.

### ABGroupAddResult
This element only contains the `<guid>` element.

#### guid
This element only contains the GUID of the newly created group.