Table of Contents

Microsoft Graph set up in Azure Directory

This guide is to help you with creating a new application in your Azure Directory to interact with the Workflow in BusinessMate. The application will need permissions to read and send mails through Microsoft Graph, the application will also need a “secret”. 


The 4 parameters for the config needs: 

  • Client ID (Application ID) 

  • Client Secret 

  • Tenant ID (Directory ID) 

  • User ID 

Azure directory

The first step is to create a new application in Azure Directory 

Login to your azure account at “”, then you will be directed to the user homepage as in figure 1.  

Now go to the “Azure Active Directory”. (Mark with red rectangle in figure 1.) 

Figure 1. Azure user homepage 

From the Azure Active Directory we can now go to the “App registrations” as shown in figure 2.

Figure 2. Azure Directory Overview

In the app registration we can now add a new app by click on the “New registration” as shown in figure 3.

Figure 3. Azure App Registration

Register application

The application needs a name, and you can select who can access this application or API.

You do not need a redirect URL for the application.

Click “Register” when you have type in a name as shown in figure 4.

Figure 4. Register Application

App (Client ID, Directory ID)

You will be redirected to the new application page where you can see the essential information’s as shown in figure 5.

Under the “Essentials”, we can get the:

Client ID (Application ID)

Tenant ID (Directory ID)

Now we need to create a new client secret by going to the “Certificates & secrets” page on the left menu bar.

Figure 5. After register the application

Create secret key

In the “Certificates & secrets” page we can now add a new client secret by clicking on the button “+ New client secret” as shown in figure 6.

Figure 6. Certificates & secrets page

After clicking the add client secret button a right sidebar will appear. Here you can give a description of the secret and set a expire date.

When you are done click on “Add” as shown in figure 7.  

Figure 7. Add client secret


Get client secret

Now you can get the client secret under “Value” as shown in figure 8.

You can only get the client secret once, after leaving the webpage it will automatically hide the client secret!

Figure 8. Client secret

Add permissions

Next step is to set permissions, so go to the “API permissions” in the left sidebar as shown in figure 9.

Figure 9. API permissions

At the permissions page click on “+ Add a permission” as shown in figure 10.

Figure 10. Permissions page

After clicking on add permission a right sidebar will appear, and you can see different Microsoft services. In our case we will click on “Microsoft Graph” as shown in figure 11.  

Figure 11. Select API Permissions 

Now click on “Application permissions” and then in the search field search for “mail”. Then open the mail dropdown and select all the permissions you want. In this guide we have selected all in mail as shown in figure 12.

When you have selected the permissions click on the button “Add permissions”.   

Figure 12. Select API Permissions for mail 

If you are the owner of the company/organization you can grant admin consent for the app, or else you will have the owner to go to the application and give consent. The Owner can grant permissions as shown in figure 13.

Figure 13. Grant permission

When permissions er granted is looks like figure 14. 

Figure 14. Permission Granted

Get user ID

The Last thing you need is user ID which can be found under “Users” in Azure Active Directory. Find the user and get his/her user ID under “Identity” in the field “Object ID” as in figure 15. 

Figure 15. User information