Getting Started with the Microsoft Graph Outlook Mail API and ASP.NET

The sample code in this repository is the end result of going through the .NET tutorial on the Outlook Dev Center. If you go through that tutorial yourself, you should end up with code very similar to this. If you download or fork this repository, you'll need to follow the steps in Configure the sample to run it.

NOTE: Looking for the version of this tutorial that used the Outlook API directly instead of Microsoft Graph? Check out the outlook-api branch. Note that Microsoft recommends using the Microsoft Graph to access mail, calendar, and contacts. You should use the Outlook APIs directly (via https://outlook.office.com/api) only if you require a feature that is not available on the Graph endpoints.

Prerequisites

• Visual Studio 2013 or Visual Studio 2015 installed and working on your development machine.
• An Office 365 tenant, with access to an administrator account in that tenant, OR an Outlook.com account.

Register the app

Head over to https://apps.dev.microsoft.com to quickly get a application ID and password. Click the Sign in link and sign in with either your Microsoft account (Outlook.com), or your work or school account (Office 365).

Once you're signed in, click the Add an app button. Enter dotnet-tutorial for the name and click Create application. After the app is created, locate the Application Secrets section, and click the Generate New Password button. Copy the password now and save it to a safe place. Once you've copied the password, click Ok.

Locate the Platforms section, and click Add Platform. Choose Web, then enter http://localhost:<PORT>/Home/Authorize under Redirect URIs, where <PORT> is the port number that the Visual Studio Development Server is using for your project. You can locate this by selecting the dotnet-tutorial project in Solution Explorer, then checking the value for URL in the Properties window.

NOTE: The values in Redirect URIs are case-sensitive, so be sure to match the case!

Click Save to complete the registration. Copy the Application Id and save it along with the password you copied earlier. We'll need those values soon.

Here's what the details of your app registration should look like when you are done.

Configure the sample

1. Open the dotnet-tutorial.sln file.

2. Right-click References in Solution Explorer and choose Manage NuGet Packages.

3. Click the Restore button in the Manage NuGet Packages dialog to download all of the required packages.

4. Create a new file, ./dotnet-tutorial/AzureOauth.config. Replace its entire contents with the following.

   <appSettings>
       <add key="ida:AppID" value="YOUR APP ID" />
       <add key="ida:AppPassword" value="YOUR APP PASSWORD" />
       <add key="ida:RedirectUri" value="http://localhost:10800" />
       <add key="ida:AppScopes" value="User.Read Mail.Read" />
   </appSettings>

5. Replace YOUR APP ID with the Application Id from the registration you just created.

6. Replace YOUR APP PASSWORD with the password you copied earlier.

Copyright

Copyright (c) Microsoft. All rights reserved.

---

Connect with me on Twitter @JasonJohMSFT

Follow the Outlook/Exchange Dev Blog