# How to monitor your Microsoft 365 instance

{% hint style="info" %}
This feature is only available starting with the Business plan.
{% endhint %}

1. Go to [Azure Portal - App registrations](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade)

   <figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2FShJJbfLSqx5PY1AztJW8%2FCleanShot%202025-04-28%20at%2009.52.49%402x.png?alt=media&#x26;token=c9fbd409-5ca2-4b20-bfc8-ac5d9aad95ed" alt=""><figcaption></figcaption></figure>
2. Create a new registration
3. Go to the API permissions menu

   <figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2Fa0j6blLQGCGkkHskz08l%2FCleanShot%202025-04-28%20at%2009.53.19%402x.png?alt=media&#x26;token=9d6250f4-791c-487f-a72e-11cf23605c99" alt=""><figcaption></figcaption></figure>
4. Remove all default permissions
5. Add new permission: Microsoft Graph -> Application permissions -> Add Permission "ServiceHealth.Read.All"
6. Grant Admin Consent for \[organization]

   <figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2FQscTU6XTEFxBswWBRZMf%2FCleanShot%202025-04-28%20at%2010.16.30%402x.png?alt=media&#x26;token=fb3fdcb2-face-42e3-81a2-dc55ddbc9d9a" alt=""><figcaption></figcaption></figure>
7. Go back to the Overview page
8. Click on "Add certificate or secret" -> New Client Secret -> Enter a description -> Choose an expiration (it should be as long as you will need it)

   <figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2Fm3psB1PvIHph9ltleCYT%2FCleanShot%202025-04-28%20at%2010.00.29%402x.png?alt=media&#x26;token=fd4776ed-f638-46d5-a088-9bce9667097e" alt=""><figcaption></figcaption></figure>
9. Save the secret and copy the value.
10. Return to IsDown and go to the "Alerts & Integrations" screen. Choose "Microsoft 365" integration.
11. Enter your Tenant ID, Client ID, and Client Secret above. Click Save.

    <figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2FAgnUSApfhXkWWVtFs0BB%2FCleanShot%202025-04-28%20at%2010.17.55%402x.png?alt=media&#x26;token=a775bd71-f8ad-4e43-a248-e5bbd66c01ed" alt=""><figcaption></figcaption></figure>
12. Congratulations! You're all set. We've created a Private 3rd-Party Service that monitors your Microsoft 365 instance.