How to use Microsoft Graph API with Laravel

by Dillon -

Microsoft Graph is a gateway to data and intelligence within Microsoft 365. Microsoft Graph is great to build apps for organizations and consumers using the vast amount of data stored in Microsoft 365. In this post, we are going to integrate with Microsoft Graph API in Laravel to get all users assigned to your tenant.

You will need to have already created an Azure App Registration to follow along with this post. If you are unsure how to create an Azure App Registration, take a look at this Quickstart Guide by Microsoft which will take you through the process.

Microsoft Graph API

Microsoft has created an open-source SDK for PHP on GitHub. Install the SDK using composer.

composer require microsoft/microsoft-graph

Or you can edit your composer.json file: 

{
    "require": {
        "microsoft/microsoft-graph": "^1.57.0"
    }
}

To make requests to Microsoft Graph API we will be using GuzzleHTTP client. It’s a great package that makes it easy to send HTTP requests and integrate with web services. Also, Guzzle comes installed with Laravel, which is great. 

I have created a Trait to help with this example. To install the Trait, under the App directory, create a new empty directory called “Integrations“. Download the Trait from Gist, and place the file within the App/Integrations directory. 

Setup Microsoft Graph API in Laravel

To get started setting up Microsoft Graph API with Laravel, keys to the .env file in the root of your Laravel application.

MS_TENANT_ID=
MS_CLIENT_ID=
MS_CLIENT_SECRET=
MS_GRAPH_API_VERSION=v1.0

How to find your Microsoft Tenant ID

To find your Microsoft Tenant ID, log in to Microsoft Azure. From the menu, select Azure Active Directory > Overview. You can find the Tenant ID within the Overview tab. 

How to find your Microsoft Azure App Client ID and Client Secret

To find your Client ID, from the same menu in Azura Active Directory select App Registrations > Your App > and Client Secrets under Essentials. The Client Secret for your Azure App is only available at the creation of the app and cannot be retrieved afterward. 

Setup Azure app permissions

We will be getting a list of users in the tenant. The permissions required to make this API request are Application Permissions.

  • User.Read.All

Admin consent id required for this permission.

List all users using Microsoft Graph API

List Users Using the MicrosoftGraph.php Trait

Use App\Integrations\MicrosoftGraph;

Return MicrosoftGraph::users();

You can get familiar with Microsoft Graph API by using the Graph Explorer by Microsoft to test different endpoints and responses.

Was this post helpful? Please leave a comment below.

Dillon Smart

👋 Hey, I'm Dillon!

I’m a Full-Stack developer in the UK, building websites and applications for around 12 years, landing my first full-time job as a developer in 2015.

Feel free to reach out on Twitter!

Comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.