Create Azure AD apps from the manifest
Tags: azureactivedirectory, azuread, climicrosoft365, microsoft365
Published: 2021-04-28 09:43:04

---
title: Create Azure AD apps from the manifest
published: true
date: 2021-04-22 11:59:19 UTC
tags: azureactivedirectory,azuread,climicrosoft365,microsoft365
canonical_url: https://blog.mastykarz.nl/create-azure-ad-apps-manifest/
---

![Create Azure AD apps from the manifest](https://blog.mastykarz.nl/assets/images/2021/01/banner-cli-m365-aad-app-add.png)

Did you ever want to create Azure AD applications from their manifest? Now you can with CLI for Microsoft 365.

## The easiest way to create Azure AD apps

Recently, I wrote about [how CLI for Microsoft 365 simplifies creating Azure AD apps](/create-azure-ad-apps-one-line-code/). With just one command, you can create a new Azure AD app registration configured with the necessary authentication settings, API permissions and more.

When you build apps on Microsoft 365, you need an Azure AD app registration for your app. The app registration represents your app on the Microsoft cloud and defines the authentication capabilities and API permissions of your app.

Because [Azure AD apps play such an important role](https://docs.microsoft.com/learn/modules/getting-started-identity/?WT.mc_id=m365-26011-wmastyka), we thought that we should simplify creating them, so that you can focus on building your app. If you script deploying your app between the different environments but also in your team, including CLI for Microsoft 365 will help you include the creation of the Azure AD app registration while keeping your script simple.

With CLI for Microsoft 365, we brought down creating Azure AD apps to just one command. But we didn't stop there.

## Create Azure AD app registrations from manifest

When building apps for Microsoft 365, you typically start by creating an Azure AD app registration. Without it, your app won't be able to connect to Microsoft 365. While developing your app, the easiest way to create and configure your Azure AD app is through the Azure Portal.

![Azure AD app registration registration in the Azure Portal](https://blog.mastykarz.nl/assets/images/2021/04/azure-portal-ad-app-registration.png)

The Azure Portal lets you easily create the app registration and configure it to match your needs. But then what, how do you share this configuration with your fellow developers or customers?

In CLI for Microsoft 365 v3.9 (available as preview when writing this article), we introduced support for creating Azure AD app registrations from their manifest. After you created and configured Azure AD app registration in the Azure Portal, go to the **Manifest** tab, copy the manifest's contents and save them to a file in your project.

![Azure AD app registration manifest in the Azure Portal](https://blog.mastykarz.nl/assets/images/2021/04/azure-portal-ad-app-manifest.png)

Next, after signing in to the tenant where you want to create your app, execute:

```sh
m365 aad app add --manifest @manifest.json
```

That's it. CLI for Microsoft 365 will take the manifest you specified and create a new Azure AD app registration with the specified configuration. If you prefer to separate configuration from code, you'll love this approach!

## Considerations

There are some limitations related to creating Azure AD apps from the manifest that you should take into account.

First, if you granted your Azure AD app permissions to custom APIs that are registered in one directory, their IDs will by likely different when you create the app registration in another directory. You can work around it, by removing the tenant-specific API permissions from the manifest, and grant them using the `apisDelegated` option, like:

```sh
m365 aad app add --manifest @manifest.json --apisDelegated 'https://contoso.microsoft.com/App.Read'
```

Another thing you should consider is, that when you look at the manifest that you copy from the Azure Portal, there are some properties that are not supported by Microsoft Graph which we use to create the app. The command automatically removes them from the manifest so that it can create the app registration but some settings will be missing in the created app.

Since we've just introduced this functionality in the v3.9 beta version of CLI for Microsoft 365, we'd love for you to give it a try and tell us what you think. Does it work? Do we miss something important? Is there anything that we should reconsider?

To see what's possible, see the [command's docs](https://pnp.github.io/cli-microsoft365/cmd/aad/app/app-add/). Looking forward to hearing from you.