This FAQ answers questions related to the Microsoft Graph quick start.
About quick start samples
The quick start samples show you how to access the power of Microsoft Graph. These samples access two services with one authentication: Azure Active Directory and Outlook. Each quick start sample accesses information from a Microsoft account user's profile and displays messages from their inbox.
The quick start involves three steps:
- Choose your language.
- Get your client ID (app ID).
- Download and run the sample.
When you complete the quick start, you have an app that's ready to run.
All quick start samples require access to either a personal Microsoft account with a mailbox on Outlook.com, or a Microsoft work or school account with an Exchange Online mailbox. If you don't have a Microsoft account, there are a few options to get a free account:
- You can sign up for a new personal Microsoft account.
- You can sign up for the Microsoft 365 Developer Program to get a free Microsoft 365 developer subscription.
Frequently asked questions
Can I get the quick start code without downloading through the quick start page?
Absolutely! Each quick start sample download is based on a Microsoft Graph tutorial, so you have two other options to get the same source code:
- Build the code yourself by following the step-by-step tutorial.
- Download the completed project from the corresponding GitHub repository and follow the instructions in the README to configure and run the sample.
To view a table of the tutorials and corresponding GitHub repositories, see Microsoft Graph tutorials.
Why don't any of the quick start samples show advanced authentication use cases?
The quick start samples give you an introduction to authentication and Microsoft Graph API calls. You can learn more about other authentication flows in the Azure Active Directory documentation.
What if I run into an unexpected error or problem with a quick start?
If you have trouble getting the quick start to work properly, open an issue on the corresponding GitHub repository. To view a table of the tutorials and corresponding GitHub repositories, see Microsoft Graph tutorials.
When running a quick start, I get error message AADSTS50011.
The error message "AADSTS50011: The reply url specified in the request does not match the reply urls configured for the application" indicates a problem with the application registration for the quick start.
When you download a quick start sample from the Microsoft Graph quick start page, we create the application registration and configure a reply URL (also known as a redirect URL) that matches the default URL used by the sample project. If you change the URL, the app registration no longer matches and could cause this error.
To resolve this error, consult the README.md file included with the quick start project for instructions about how to create an app registration and configure it in the sample code.
After signing in, I'm told I need admin approval.
After signing into one of the quick start samples, you might see the following message: "Need admin approval: XXX Tutorial needs permission to access resources in your organization that only an admin can grant. Please ask an admin to grant permission to this app before you can use it."
This isn't a bug with the sample. None of the quick start samples request any Microsoft Graph permission scopes that by default require admin consent. Tenant administrators can disable your ability to consent to Microsoft Graph permission scopes for any apps that they have not approved. In that case, you see this error.
To resolve this error, work with your administrators to get approval, use a personal Microsoft account (Outlook.com), or use a test Microsoft 365 tenant with Exchange Online.
Didn't find what you need?
If this FAQ didn't address a question or problem that you encountered with one or more of the quick start samples, let us know by using the following Feedback section.