Microsoft Graph Quick Start

Build a simple app that connects to Office 365 and calls the Microsoft Graph API.

  1. This Microsoft Graph quick start uses the v2.0 endpoint for authentication and app registration. We recommend the v2.0 endpoint for personal accounts. Note that not all authentication scenarios are currently supported on the v2.0 endpoint and it is not recommended for enterprise scenarios; for details, see Should I use the v2.0 endpoint? If you are building for enterprise, see Getting Started (V1.0 endpoint).

  2. If you have an existing,, or account, your mailbox might not support calls using the Microsoft Graph or the Outlook endpoint.  We’re working on this. In the meantime, if you’d like to use the APIs to access consumer services such as or, we suggest that you create a new Microsoft account.

  3. If you plan to use services such as Groups, OneDrive for Business, Azure Active Directory, Planner, or Excel, you will need a work or school account. If you don’t have one, you can join the Office 365 Developer program to get a free 1-year subscription.


Learn about quick starts and pick your platform

The quick start samples show you how to access the power of the Microsoft Graph. Previously, you had to authenticate to each service you wanted to call. Microsoft Graph eliminates this complexity for developers by unifying authentication and combining all API entry points into one entry point. Now you authenticate once and get the power to access information across multiple applications and services.

The quick start example accesses 3 services with one authentication: Azure Active Directory, OneDrive, and Outlook. Each quick start pulls information from an Azure AD user profile, writes it to OneDrive (a photo), and sends an email using Outlook (including a link to the photo).

Please pick your platform to get started:



Start coding

Download our code sample to get going. This sample will introduce you to authentication and send an email from your account.


Did that work for you?

Were you able to sign in and send an email?

1. These quick starts are not designed to be production-ready code; they are just easy illustrations for how you can do the same scenario across many different programing languages and platforms. Once you do a quick start, we recommend you fully understand authentication to create production-ready apps.
2. You can manage and configure your applications or create a new one at the Application Registration Portal.
* The Android robot is reproduced or modified from work created and shared by Google and used according to terms described in the Creative Commons 3.0 Attribution License.