Protocols/MSNP/Commands/ADD

ADD

SUMMARY

Adds a principal to one's contact list.

SYNTAX

 ADD trid list email display-name [group-num]

• list: one of "AL", "BL", "FL".

RESPONSE

 ADD trid list ver-num email display-name [group-num]

• ver-num: Was used to support revision numbers of the contacts list, but now 1 since the feature was dropped.

DESCRIPTION

The principal with the specified email is added to the specified list with the specified name. If adding to the FL, it is optionally added to the group specified (or group 0 if no group is specified.)

ERRORS

• 201: Invalid email address
• 205: Nonexistent principal
• 210: Limit of 300 principals exceeded
• 215: Principal already in group
• 219: User cannot be in AL and BL simultaneously
• 224: Nonexistent group

Attempting to add principals to one's RL will cause disconnection.

VERSION

MSNP8, MSNP9

Deprecated in MSNP11: see ADC and MSNP11 changes