Getting started with Graph APIs

Microsoft Graph Quick Start

This quick start will let you try out calls, register your app, and download a sample app that connects to data using Microsoft Graph. The sample app sends an email on a user's behalf. It will show you how to authenticate and make calls to Microsoft Graph using a school or work or a Microsoft account.


  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 hotmail.com, live.com, or outlook.com 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 Outlook.com or OneDrive.com, 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.

Try it out

Pick an API, try different values, and choose the Try button to see the responses from a sample tenant.



GET

Pick the platform you'll be building for

Build a simple app that connects to Office 365 and calls the Microsoft Graph API. After you pick your platform, you'll walk through getting the right tools, registering your app, and running the code.

Register the sample app

To register your app, we will take you to the Microsoft Application Registration portal where you will be able to get an App ID and redirect URL. You will need either a school or work or Microsoft account.


This sample app will work for most users*.

Start coding

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


Please re-enter the App Secret that you generated and saved:

More Resources

* 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.