What’s new in EWS and other web services in Exchange

Exchange Server 2013

Find out what’s new in EWS and web services in Exchange and the EWS Managed API.

Last modified: March 09, 2015

Applies to: EWS Managed API | Exchange Online | Exchange Server 2013 | Office 365

In this article
eDiscovery in EWS
Archiving in EWS
Personas in EWS
Unified Contact Store in EWS
Retention policies in EWS
Requesting user photos
Block senders and mark email as junk in EWS
Mail apps for Outlook
Propose new meeting time
Additional resources

Web services in Exchange have been updated to include new features.

Table 1.  New web service features in Exchange Online, Exchange 2013, and the EWS Managed API


Implemented in Exchange Online

Implemented in Exchange 2013

Implemented in the EWS Managed API













Unified Contact Store




Retention policies




User photos




Mail apps for Outlook management




Propose new meeting time




eDiscovery is a federated query web service that enables external applications, such as SharePoint 2013, to perform queries of Exchange data. Discovery consists of several phases, including identifying and preserving key data, culling down and reviewing the data, and producing data in court. eDiscovery queries facilitate the discovery process by providing a single discovery workflow across Exchange and SharePoint.

Table 2. EWS operations and EWS Managed API methods for working with eDiscovery

Operation name

EWS Managed API method


GetDiscoverySearchConfiguration operation


Gets configuration information for in-place holds, saved discovery searches, and the mailboxes that are enabled for discovery search.

GetHoldOnMailboxes operation


Gets the status of a query-based hold, which is set by using the SetHoldOnMailboxes operation.

GetNonIndexableItemDetails operation


Gets details about items that cannot be indexed. This includes, but is not limited to, the item identifier, an error code, an error description, when an attempt was made to index the item, and additional information about the item.

GetNonIndexableItemStatistics operation


Gets the count of items that cannot be indexed in a mailbox.

GetSearchableMailboxes operation


Gets a list of mailboxes that the client has permission to search or perform eDiscovery on.

SearchMailboxes operation


Searches for items in specific mailboxes that match query keywords.

SetHoldOnMailboxes operation


Sets a query-based hold on items.

Archive mailboxes are secondary mailboxes that are associated with a user. Archive mailboxes are typically used to manage email storage limits. For example, older email items might periodically be moved from the Inbox to the archive mailbox.

Exchange introduces two new EWS operations that you can use to archive a set of mail items from a primary mailbox. Archiving Inbox items in this way preserves the folder hierarchy of the items. In addition, archive mailboxes can now be stored either locally on a client, or remotely, in a way that is mostly opaque to a user, by using a folder path to point to the contents of the archive.

Table 3. EWS operations and EWS Managed API methods for working with archiving

Operation name

EWS Managed API method


ArchiveItem operation


Moves an item from the primary mailbox to the archive mailbox.

CreateFolderPath operation

Not implemented.

Creates a folder hierarchy in a primary or archive mailbox.

A persona is a collection of data that is associated with an individual. The data can come from one or more sources and is associated with the persona by means of a common link ID. Personas in EWS enable you to link, search, browse, and retrieve information about a person from multiple sources and organize that information into a single logical entity. Personas differ from contacts in that a contact is a collection of data from a single source that is associated with an individual; for example, a personal Outlook contact or an entry in a global address list (GAL).

The EWS Managed API does not implement this functionality.

Note Note

The Unified Contact Store also exposes persona functionality by means of the operations that support that feature.

Table 4.  EWS operations for working with personas

Operation name


FindPeople operation

Returns all persona objects from a specified contact folder or retrieves all contacts that match a specified query string.

GetPersona operation

Retrieves a persona.

The Unified Contact Store is a feature that provides a consistent contact experience across Office products and acts as an integration point for third-party applications to use the same contact store. It allows users and applications to store, manage, and access contact information and make it available globally among Lync, Exchange 2013, Outlook, Outlook Web App and any other application that implements access to the Unified Contact Store. Exchange is the contact store for the Unified Contact Store experience.

The EWS Managed API does not implement this functionality.

Table 5.  EWS operations for working with the Unified Contact Store

Operation name


AddNewImContactToGroup operation

Adds a new IM contact to a group. The Unified Contact Store can contain a maximum of 1000 contacts.

AddImContactToGroup operation

Adds an existing IM contact to a group. The Unified Contact Store can contain a maximum of 1000 contacts.

AddImGroup operation

Adds a new IM group. The Unified Contact Store can contain a maximum of 64 groups.

AddNewTelUriContactToGroup operation

Adds a new contact to a group based on a contact's phone number.

AddDistributionGroupToImList operation

Adds a new distribution list group. The Unified Contact Store can contain a maximum of 64 groups.

GetImItemList operation

Retrieves a list of IM groups and IM contact personas.

GetImItems operation

Retrieves information about the specified IM groups and IM contact personas.

RemoveContactFromImList operation

Removes the specified contact from all IM groups.

RemoveImContactFromGroup operation

Removes an IM contact from a group.

RemoveDistributionGroupFromImList operation

Removes the specified IM distribution list group.

RemoveImGroup operation

Removes the specified IM group.

SetImGroup operation

Changes the display name of a group.

Retention policies are policies that are used in Exchange to group one or more retention tags, to apply retention settings to folders or individual items such as email and voice mail messages, and to apply retention settings to a mailbox.

Exchange includes three types of retention tags:

  • Default policy tags that apply to mailbox items that have no other type of retention tag applied.

  • System folder policy tags that are applied to default folders such as the Inbox.

  • Personal tags that a user can apply to folders they create or to individual items.

Only one retention policy can be assigned to a mailbox, but the policy can have one or more retention tags of various types linked to it. Retention tags can be linked to or unlinked from a retention policy at any time. EWS in Exchange exposes a new operation, GetUserRetentionPolicyTags, and the EWS Managed API implements a new method, ExchangeService.GetUserRetentionPolicyTags(), that provides a list of all the tags that are linked to a retention policy. You can set and retrieve retention policy tags for items and folders by using the CreateItem, CreateFolder, UpdateItem, UpdateFolder, GetItem, and GetFolder operations.

You can request user photos from the Exchange server by using one of the two implementations of the GetUserPhoto operation: REST or SOAP. The REST endpoint uses a standard HTTPS GET request to get the user photo. The service will either return a user photo stored in Exchange or a photo from Active Directory Domain Services (AD DS).

The EWS Managed API does not implement this functionality. You can, however, use the EWS Managed API to return user photos that are stored in a mailbox by getting the photo that is attached to a contact.

You can now block senders and mark email as junk by using the new MarkAsJunk operation in EWS or the ExchangeService.MarkAsJunk() method in the EWS Managed API.

EWS now includes support for managing mail apps for Outlook.

Table 6. EWS operations and EWS Managed API methods for working with mail apps for Outlook

Operation name

EWS Managed API method


DisableApp operation


Disables an installed app.

GetAppManifests operation


Gets the app manifests for a mailbox.

GetAppMarketplaceUrl operation


Gets the app marketplace URL.

GetClientAccessToken operation


Gets client access tokens.

InstallApp operation


Installs an app for a mailbox.

UninstallApp operation


Uninstalls an app from a mailbox.

The propose new time feature was introduced in version 15.00.0800.007 of Exchange. This allows meeting attendees to propose new meeting times to the meeting organizer.

The EWS Managed API does not implement this functionality.