Add Ins Connectors REST APIs Actionable Messages Feedback Blog Code Samples Videos

One Outlook REST API. Your favorite platform. 400+ million users.

With the simplicity of REST, you can use your favorite language and IDE, write your app once, and capture 400 million monthly active Outlook.com users, and tens of millions active Office 365 users.

Start with choosing a language for your app - Node, Python, Ruby, Swift - just to name a few. Write the code, take advantage of new, streamlined services to register and authorize the app, and access user's mail, calendar, and contacts data on Outlook.com or Office 365. You can use the same Outlook REST API for Android, iOS, Windows, on the web, mobile, and desktop. There's no need for any specialized Exchange knowledge!

It's this straightforward:

  1. Register your app. Registration takes only a minute.
  2. Start coding and implement REST API calls.

Streamlined services

There's just one simple process for Outlook.com and Office 365 - register and get dynamic user authorization to access users’ mail, calendar and contacts.

Take an early look at the following services in preview status:

  • Application Registration Portal

    Use a Microsoft account or Office 365 subscription account to register your app. It takes only a few steps to identify your app for Outlook.com and Office 365.

  • v2 endpoints:

    Use these common authentication endpoints to sign users in with their personal Outlook.com accounts, or business or school credentials, and request authorization for access. Instantly expand the reach of your app!

    • https://login.microsoftonline.com/common/oauth2/v2.0/authorize
    • https://login.microsoftonline.com/common/oauth2/v2.0/token

Use these preview services when:

  • Rewriting existing Outlook.com apps* that use the Windows Live API. Windows Live API has been deprecated for Outlook.com. Plan to accommodate changes to these services over their preview period.
  • Creating new Outlook.com* and Office 365 apps that access mailbox data.

Plan to upgrade in-production Office 365 apps once the preview period is over.

  • Make sure Outlook.com apps handle user mailboxes that have not been enabled for the Outlook REST API. API calls made against these users will return either MailboxNotEnabledForRESTAPI or MailboxNotSupportedForRESTAPI error codes. See Use the Outlook REST API for more information.

Outlook REST API

Use one common REST endpoint -

https://outlook.office.com/api/{version} 

to make all Outlook REST API calls in the following APIs: