Start using web services in Exchange

Find information to help you get started with EWS and other web services in Exchange.

The web services in Exchange provide access to mailbox data stored in Exchange Online, Exchange Online as part of Office 365, and on-premises versions of Exchange starting with Exchange Server 2007, and enable you to create custom applications that you can use to manage that information according to the requirements of your organization. While the range of EWS and web service applications that you can create is practically infinite, certain fundamental concepts apply for any type of application. This section provides information about the fundamental concepts you need to be familiar with in order to start using EWS and other web services in Exchange.

Build your knowledge

Whether you use the .NET Framework or another platform to develop your web service application, you will want to understand some important concepts before you begin your development project.

Table 1. Web services concepts

Concept Summary
Learn about how EWS works within the Exchange architecture and the protocols it uses.
EWS application types
Find out about the most common types of applications that you can create by using EWS in Exchange.
EWS access
Exchange administrators can limit access to EWS globally for the entire organization, for individual users, and to individual applications. Find out which access level is right for you.
Find information about the tasks you need to complete in order to create applications that use the EWS Managed API or EWS to communicate with Exchange.
Learn about the authentication options for connecting to Exchange Online and Exchange on-premises.
Learn about the set of services that you can use to discover the URL endpoint where a user's account can access information via EWS.
Mailbox server
Find out about the primary repository of information made available to an EWS client. EWS has access to a limited set of information stored in Active Directory Domain Services (AD DS).
Mail apps for Outlook and EWS
Find information about mail apps for Outlook and how they work with EWS in Exchange.
Office 365 REST APIs for mail, calendars, and contacts
Learn about the Office 365 APIs that you can use to access mail, calendars, and contacts in Exchange Online as part of Office 365.
The EWS Managed API
Find information about the preferred client API for .NET Framework developers.
Find information about creating your first application by using EWS XML requests and responses.
EWS functionality in Exchange product versions
Find out what EWS functionality is available in version of Exchange.
Trace and troubleshoot
Find out how to trace EWS requests and responses in order to troubleshoot errors in your EWS Managed API application.

Create your first application

If you're ready to get to the business of writing your first .NET Framework or EWS client application, see Get started with EWS Managed API client applications or Get started with EWS client applications.

Get code samples

To find code samples and examples that show you how to work with EWS and other web services in Exchange, see the following resources:

Many other samples are available in blogs, code demonstration sites, and forums. We also recommend that you download the EWSEditor. This project implements most of the EWS functionality; you can find examples of all the core EWS functionality here.

If you're not a .NET Framework developer, you can find many client libraries out there for EWS development that use Java, Python, PHP, and other languages.

Ask questions and solve problems

Need help getting things done and you're not finding answers? You can search the Exchange Development forum to find out whether someone else has encountered and resolved the same issue. A community of contributors have answered hundreds of questions about Exchange development. You can also find third-party sites, forums, and blogs that cover Exchange development and might have the solution you're looking for.

Contact Microsoft support if you need additional assistance. The Exchange Developer support team is staffed with seasoned professionals who can help answer your questions about Exchange development.

See also