Skip to content

Office 365

The Office 365 application allows you to retrieve multiple information about your tenant.

Require Microsoft Graph API Permission: ServiceHealth.Read.All, DeviceManagementManagedDevices.Read.All, Reports.Read.All, Organization.Read.All

Options

  • Name: Just a simple label to find it easier in the SenHub's interface
  • Description: Description for your own usage only.
  • Vault: Choose in the list box the appropriate vault for this resource. If you have not created it yet, see how to add a vault.
  • Tenant Name: The name of your Microsoft Azure tenant.
  • Resource Types: 4 types of information can be retrieved. Depending on your choice you will have access to advanced settings or not.
    • Apple push notification certificate — If you deploy Apple devices in your mobile fleet, a certificate is required for Office 365 to send notifications to its applications on these devices. Like any certificate, it has a validity date that once exceeded prevents users from being notified. It is a good idea to keep an eye on it in order to replace it before a service interruption. No options.
    • License — This option allows you to list all the licenses of your tenant. You will have the possibility to filter the output using either a white list (include mode) or a black list (exclude). You can also change the output format to see the number of total and used licenses in one go, either one or the other, or to retrieve the percentage of free licenses.
      • Output format: All, Free, Total or Free percent.
      • Filter: None, Include or Exclude.
      • Filter expression: The filter target.
    • Mailflow — The mailflow option allows us to retrieve information about the tenant's email traffic. However, we are facing some constraints imposed by Microsoft: The freshest data available online is calculated on D-2 and on a sliding window of 7 days. No options.
    • Service Health — It can be interesting to track the status of Office 365 services to understand where a service degradation is coming from for your users. In this case, it is necessary to be interested only in those actually used by your company so as not to receive information that does not concern you. No options.

Example output

The channels returned depend on the selected Resource Type. With License (Output format All), the connector returns one free-licenses and one total-licenses channel per SKU:

{
  "metrics": [
    { "channel": "Office 365 E3 - Free licenses", "value": 8, "unit": "#" },
    { "channel": "Office 365 E3 - Total licenses", "value": 50, "unit": "#" },
    { "channel": "Microsoft 365 Business Premium - Free licenses", "value": 3, "unit": "#" },
    { "channel": "Microsoft 365 Business Premium - Total licenses", "value": 25, "unit": "#" }
  ],
  "message": "Metrics successfully retrieved.",
  "status": "OK",
  "date": 1725981405127
}

With Service Health, one channel per Microsoft service reports its current status string:

{
  "metrics": [
    { "channel": "Exchange Online", "value": "serviceOperational" },
    { "channel": "Microsoft Teams", "value": "serviceDegradation" },
    { "channel": "SharePoint Online", "value": "serviceOperational" }
  ],
  "message": "Metrics successfully retrieved.",
  "status": "OK",
  "date": 1725981405127
}

With Mailflow, the connector aggregates the tenant email-activity report (7-day window, D-2 data). The Apple push notification certificate type instead returns two channels, Days to expiration and Expiration date:

{
  "metrics": [
    { "channel": "Report Refresh Date", "value": "2026-07-18", "unit": "#" },
    { "channel": "Total send", "value": 12500, "unit": "#" },
    { "channel": "Total receive", "value": 48200, "unit": "#" },
    { "channel": "Total read", "value": 39100, "unit": "#" },
    { "channel": "Total meeting created", "value": 640, "unit": "#" }
  ],
  "message": "Metrics successfully retrieved.",
  "status": "OK",
  "date": 1725981405127
}