Office 365 Integration

This integration enables the flow of data from Office 365 directly into IT Glue. Tenants, Users and Mailbox information will sync automatically, staying accurate and up to date.

Benefits of this integration include:

  • Managing the options of your Office 365 asset including manual syncing and comparing data between IT Glue and Office 365
  • Jump from IT Glue to a User List in the Tenant Portal when you click Manage on a synced Contact
  • Viewing logs related to your Office 365 integration in the Sync Logs

At any time, you can come back to the Active Integrations screen (Account > Integrations) to make changes to the integration.

The field mappings are set up automatically when you follow the instructions below. For more information, take a look at Office 365 Field Mapping.


  • Manager or Administrator access to IT Glue
  • One free data source
  • Microsoft Cloud Partner certified to offer delegated administration
  • Delegated admin permissions to each of your clients' Office 365 tenants through your own Office 365 admin portal, rather than direct logins to their admin portals
Note: The Office 365 integration does support direct logins to client admin portals, but integrating in this way requires an additional data source, and following the steps in this article, for each client you wish to integrate.

Create an Azure Active Directory Application

Before integrating your Office 365 Tenants into IT Glue, you need to create an application through the Azure Active Directory Admin Center.

The following steps must be completed to create your application:

Create Application

  1. Sign in to your Office 365 Account.

  2. On the left hand sidebar, expand Admin centers and select Azure Active Directory.

  3. Select App registrations.

  4. Select New application registration.

  5. Provide a name and URL for the application. Select Web app / API for the type of application you want to create. After setting the values, select Create.


    You have created your application.

Get Application ID 

  1. From App registrations in Azure Active Directory, select View all applications.

  2. Select your application.

  3. Copy the Application ID and store it in IT Glue.


Get Authentication Key

  1. To generate an authentication key, select Settings.

  2. Select Keys.

  3. Provide a description and a duration for the key. When done, select Save.

  4. After saving the key, the value of the key is displayed. This is your Secret Key. Copy this value because you are not able to retrieve the key later. You provide the key value with the Application ID to sign in as the application. Store the key in IT Glue.


Add Permissions

You will need to add API access to complete the application. The APIs you need are Windows Azure Active Directory, which is automatically added when you create the application, and Microsoft Graph.

  1. To edit the Azure Active directory and add APIs, select Settings.

  2. Select Required Permissions.

  3. Click Add in the Required Permissions column.
  4. Click Select an API in the Add API column.
  5. Click Windows Azure Active Directory in the Add API Access column.
  6. In the Enable Access column under Application Permissions, select Read and write directory data. 
  7. Deselect Sign in and read user profile under Delegated Permissions.
  8. Click Select and then Grant Permissions to save your changes.


  1. Click Add in the Required Permissions column.
  2. Click Select an API in the Add API column.
  3. Click Microsoft Graph in the Add API Access column.
  4. In the Enable Access column under Application Permissions, select:
    • Read all users' full profiles
    • Read all usage reports
    • Read all directory data
  5. Click Select and then Grant Permissions to save your changes.


  1. After granting permissions, visit the "Properties" page in the configured Application, and set Multi-tenanted to On.


Get Tenant ID

  1. Select Azure Active Directory.


  2. To get the tenant ID, select Properties for your Azure AD tenant. Copy the Directory ID. This value is your Tenant ID. Store the Tenant ID in IT Glue.


  3. Use the Application and Tenant ID, and Secret Key to start your Office 365 Integration.

To Integrate Office 365 with IT Glue

  1. Navigate to Account > Integrations and choose Office 365.

  2. Enter your application sign in information and click Connect.

  3. After you enter your Office 365 sign in information in IT Glue, you'll be taken to the following screen:

  4. From the Sync your data with Office 365 screen, tell us how much of your data to sync. By default, recommended options are listed first. Your options may look different than in the screenshot above.
    Note: As a best practice, we recommend you only select the user subscriptions that you actively manage.
  5. Click Save and Continue. The sync will be automatically queued.
  6. By default, newly queued syncs are scheduled to take place one hour later. You can use the manual sync option to prioritize the sync to start sooner. From the Active Integrations screen (Account > Integrations), click Actions and then Start Manual Sync.

  7. From the Active Integrations screen, you can see the overall sync status. When the sync is complete, the status column changes from Syncing... to OK.



    If you have a Microsoft Partner Network account with access to multiple tenants, disconnecting an Office 365 integration will not remove Admin privileges from your configured application. Remove these Admin privileges yourself or delete the configured application if no longer needed.  

View Synced Contacts

IT Glue discovers tenants and users and tries to match them to data in your account based on the following logic:

Rule Matches On
Organization Tenant Name
Contact Email Address Username + "@" + Domain

If no organization can be matched automatically, suggestions will be made based on name similarity. If no suggestions can be made, you will have the option to create a new organization.

  1. From Account > Integrations, click on Actions and then Matching.
  2. Start with the Unmatched filter to review unmatched organizations. unmatched_2.png
  3. If you're happy with any suggested match, click Accept Suggestion to accept it, or, you can search for and choose a different organization using the Match To column. You can also choose to ignore organizations, which means they won't count as unmatched items in subsequent syncs.
    Warning. If you don't see an organization, you can choose the Create Organization action to create (import) it. Make sure there is nothing to match first, so that you don't create a duplicate organization.
  4. Keep going through all your unmatched organizations until they are all matched.
  5. If you change your mind about any of the matches, click Actions, choose Change Match, and then manually search for and choose a different organization. Change_matching.png

    Note: Contact matching behaves slightly differently to standard matching logic. If no match can be made based on the criteria in the table above, a new contact will be created without further user input.
  6. Once all organizations have been matched, you can click on any matched tenant to take you to the relevant organization. 365_Tenant_matching.png
  7. Click Contacts from the sidebar. ITG_Contacts_select.png
  8. Click on any contact that has corresponding data in Office 365. ITG_Contacts.png

    You will be able to see the additional data overlay as shown below.

  9. Continue on to the Office 365 License Integration.
Was this article helpful?
11 out of 13 found this helpful
Have more questions? Contact us