# Table of contents:

• Introduction
• Client/Request
• Server/Response
• Examples
  • With list versions
    • Normal use
    • Cannot create more than 30 groups
    • Group name too long
    • Group name extremely long
  • Without list versions
    • With group IDs
      • Normal use
      • Cannot create more than 30 groups
      • Group name too long
      • Group name extremely long
    • With group GUIDs
      • Normal use
      • Cannot create more than 30 groups
      • Group name too long
      • Group name extremely long
• Known changes

# Introduction

ADG is a command introduced with MSNP7.

It is a Notification Server command, without a request or response payload.

Creates a new group. Replaced with Address Book Service's ABGroupAdd in MSNP13.

# Client/Request

ADG TrID group-name {0}

Where group-name is the name of the group you'd like to create. Has a limit of 61 bytes (URL encoded characters count as 3 bytes).

Where 0 is always 0. Removed in MSNP10.

# Server/Response

ADG TrID {list-version} group-name group-id {0}

Where list-version is the new List Version. Removed in MSNP10.

Where group-id is your new group's identification number.

Where 0 is always 0. Removed in MSNP10.

# Examples

# With list versions

Only in MSNP7 to MSNP9.

# Normal use

C: ADG 1 New%20Group%201 0
S: ADG 1 256 New%20Group%201 29 0

# Cannot create more than 30 groups

C: ADG 2 New%20Group%202 0
S: 223 2

# Group name too long

C: ADG 3 This%2062%20character%20group%20name%20is%20%invalid.%20There. 0
S: 229 3

# Group name extremely long

NOTE: This has been line-breaked. Lines beginnging with .. followed by a space are continuations of the previous line.

C: ADG 3 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA 0

Server disconnects client.

# Without list versions

# With group IDs

Only in MSNP10 with ABCHMigrated: 0.

# Normal use

C: ADG 4 Friends
S: ADG 4 Friends 1

# Cannot create more than 30 groups

C: ADG 5 New%20Group%203
S: 223 2

# Group name too long

C: ADG 6 This%2062%20character%20group%20name%20is%20%invalid.%20There.
S: 229 6

# Group name extremely long

NOTE: This has been line-breaked. Lines beginnging with .. followed by a space are continuations of the previous line.

C: ADG 7 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA

Server disconnects client.

# With group GUIDs

Since MSNP10 with ABCHMigrated: 1.

# Normal use

C: ADG 8 Friends
S: ADG 8 Friends f60efbe7-94af-4b16-b926-e4e10878d329

# Cannot create more than 30 groups

C: ADG 9 New%20Group%203
S: 223 9

# Group name too long

C: ADG 10 This%2062%20character%20group%20name%20is%20%invalid.%20There.
S: 229 10

# Group name extremely long

NOTE: This has been line-breaked. Lines beginnging with .. followed by a space are continuations of the previous line.

C: ADG 11 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.. AAAAAAA

Server disconnects client.

# Known changes

• MSNP10: Removed unused 0 parameter, Returns a GUID instead of a Group ID if ABCHMigrated: 1.
• MSNP13: Removed (automatic disconnect), use Address Book Service's ABGroupAdd instead.