This HTTP/1.1 POST method request returns the Universal Resource Identifier (URI) of the Email container that is created, including its ID.
POST
/LiveContacts/contacts/contact(ContactID)/emails
HTTP/1.1
Email
N/A
A maximum of one Email element can be inserted in one call.
An Email ID is automatically generated for the newly added record. Then, the Email ID is returned in the location header.
HTTP/1.1 201 Created Location: https://livecontacts.services.live.com/users/@L@<lid>/rest/livecontacts/contacts/contact(ContactID)/emails/email(EmailID)
For detailed information about possible error codes that are returned by this request, see Windows Live Contacts API: Error/Response Codes
Header: POST /LiveContacts/contacts/contact(ContactID)/emails HTTP/1.1 Body: <Email> <EmailType>EmailType<EmailType> <IsDefault>TrueFalse</IsDefault> <Address>EmailAddress</Address> </Email>