Protocols/MSNP/Commands/ADD
MSNP Protocol |
Introduction • Terms • Clients |
Reference |
Error List • Commands • Relying Party Suite • Spotlife |
Services |
XMPP • HTTP Gateway • Tabs • Activities |
Documentation |
Development Tools • MSNP Grid |
Polygamy • URLs used by MSN |
Documents |
Protocol Versions |
Version 21 |
Version 18 |
Version 16 |
Version 15 |
Version 14 |
Version 13 |
Version 12 |
Version 11 |
Version 9 |
Version 8 |
Version 2 |
MSNC |
Introduction • P2P • Object Descriptor • Display Pictures • File Transfer |
Scenarios |
Microsoft Messenger for Mac |
MSNP on WebTV (MSNTV) |
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