Table of contents

• Introduction
• Prerequisites
• Find the system-assigned redirect URI
• Register and configure the app
• Build and debug
• Questions and comments
• Additional resources

##Introduction

This sample shows how to connect your Windows 10 Universal app to Office 365 using the Microsoft Graph API (previously called Office 365 unified API) to send an email. It also uses the new Windows 10 WebAccountManager API to authenticate users in your tenant.

Note: To understand the code for calling Microsoft Graph in a UWP app, see [Call Microsoft Graph in a universal Windows 10 app] (https://graph.microsoft.io/docs/platform/uwp).

Note: Try out the Get started with Office 365 APIs page, which simplifies registration so you can get this sample running faster.

This sample requires the following:

• Visual Studio 2015
• Windows 10 (development mode enabled)
• An Office 365 for business account. You can sign up for an Office 365 Developer subscription that includes the resources that you need to start building Office 365 apps.
• A Microsoft Azure tenant to register your application. Azure Active Directory (AD) provides identity services that applications use for authentication and authorization. A trial subscription can be acquired here: Microsoft Azure.

Important: You will also need to ensure your Azure subscription is bound to your Office 365 tenant. To do this, see Associate your Office 365 account with Azure AD to create and manage apps for more information.

Before you can register the application in the Azure portal, you need to find out the application's redirect URI. Windows 10 provides each application with a unique URI and ensures that messages sent to that URI are only sent to that application. To determine the redirect URI for your project:

1. Open the solution in Visual Studio 2015.
2. Make sure that your Platform Target is set to x86 or x64.
3. Press F5.
4. After the app launches, choose the Copy button located in the menu on the top left of the app. This will copy the redirect URI for the app to the clipboard.
5. Store this value. You will use it when registering the app, as described in the following section.

The redirect URI value will look something like this:

ms-appx-web://Microsoft.AAD.BrokerPlugIn/S-1-15-2-694665007-945573255-503870805-3898041910-4166806349-50292026-2305040851

##Register and configure the app

1. Sign in to the Azure Management Portal using your Azure AD credentials.
2. Click Active Directory on the left menu, then select the directory for your Office 365 developer site.
3. On the top menu, click Applications.
4. Click Add from the bottom menu.
5. On the What do you want to do page, click Add an application my organization is developing.
6. On the Tell us about your application page, select NATIVE CLIENT APPLICATION for type and specify a name for the app, for example O365-UWP-Connect.
7. Click the arrow icon on the lower-right corner of the page.
8. On the Application information page, enter the redirect URI value that you obtained during the previous step.
9. Once the application is successfully added, you'll be taken to the Quick Start page for the application. From there, select Configure in the top menu.
10. Under permissions to other applications, select Add application. In the dialog box, select the Microsoft Graph application. After you return to the application configuration page, select the Send mail as a user and Sign in and read user profile permissions.
11. Copy the value specified for Client ID on the Configure page.
12. Click Save in the bottom menu.

Note: If you see any errors while installing packages during step 2, make sure the local path where you placed the solution is not too long/deep. Moving the solution closer to the root of your drive resolves this issue.

1. After you've loaded the solution in Visual Studio, configure the sample to use the client id that you registered in Azure Active Directory and the domain of your tenant by adding the corresponding values for these keys in the Application.Resources node of the App.xaml file. `

2. Press F5 to build and debug. Run the solution and sign in to Office 365 with your organizational account.

We'd love to get your feedback about the UWP Microsoft Graph Connect project. You can send your questions and suggestions to us in the Issues section of this repository.

Your feedback is important to us. Connect with us on Stack Overflow. Tag your questions with [MicrosoftGraph] and [office365].

• Other Office 365 Connect samples
• Microsoft Graph overview
• Office 365 APIs platform overview
• Office 365 API code samples and videos
• Office developer code samples
• Office dev center

Copyright (c) 2015 Microsoft. All rights reserved.