| Element | Max/Type | Min Occurrences | Max Occurrences | Create | Update |
| <Email> | | 0 | n | - | - |
| <ID>EmailID</ID> | guid | 1 | 1 | RO | RO |
| <EmailType>WindowsLiveID</EmailType> | enum | 1 | 1 | RW | RO |
| <Address>someone@example.com</Address> | 321 chars | 1 | 1 | RW | RW |
| <IsIMEnabled>TrueFalse</IsIMEnabled> | boolean | 1 | 1 | RO | RO |
| <IsDefault>TrueFalse</IsDefault> | boolean | 1 | 1 | RW | RW |
| </Email> | | | | | |
Details
- ID: Initially linked to the EmailType, this is the unique identifier for the Email record associated with this contact. It cannot be updated.
- EmailType: Once created, the EmailType of an existing Email record cannot be changed. If an e-mail address changes type, then a new record would need to be created and the existing one deleted. It is not possible to create more than one instance of the same EmailType associated with one contact. Valid values are:
- WindowsLiveID
- Personal
- Business
- Other
- Address: If this contact was created through a subscription or friend mechanism without knowing the Windows Live ID, the contact may be linked to a Windows Live profile or space, but the Windows Live ID will not be available to the address book owner until explicitly set through the API with a POST method call. If the Windows Live ID EmailType is used, then this Address value is checked to ensure it is a valid Windows Live ID. Any other EmailType Address value is validated for conformity with the e-mail format. This value must be a valid SMTP address. The validation was jointly defined with Hotmail and matches Hotmail's validation criteria. The validation will fail if any of the following conditions are true:
-
there is no @ sign,
-
@ is the first character,
-
@ is the last character,
-
there is no dot after the @,
-
a dot is the last character,
-
a space exists within the string,
-
a comma exists anywhere in the string,
-
there is more than one @.
- IsIMEnabled: If this e-mail address is set up in the service to allow Messenger Communication, this value is set to the value of True.
- IsDefault: If the internal PrimaryEmailType equals this EmailType then this flag is set to the True value, otherwise the default value of False is used until set otherwise by the caller.
If the Windows Live ID EmailType is removed on an auto-updating contact, then the contact will no longer receive updates and that flag will be set to the value of False.
If the Address of the Windows Live ID EmailType is updated, then the IsIMEnabled flag will be set to the value of False automatically.