Skip to main content

Microsoft GraphAPI

At the end of 2022, Microsoft disabled the Office 365 basic authentication meaning FuseMetrix can no longer collect emails using a simple username/password. To allow access going forwards, you'll need to setup Microsoft Graph API access.

Setup of Office 365 to enable permissions

This step is not under control of FuseMetrix, we do not have access to your Office 365 account so this must be done by the your IT department.

  1. An administrator needs to login to portal.azure.com

  2. Click the hamburger menu in top left and choose Azure Active Directory

  3. Take note of the Primary domain (usually [companyname].onmicrosoft.com )

  4. On the left hand menu, click App registrations

  5. Click + New registration

  6. Enter the Name "FuseMetrix" and click Register

  7. Take note of the Application (client) ID (it will look something like this: d728d714-c49b-4ec7-ad35- 05f95b604a59 )

  8. Click Add a certificate or secret

  9. Under the Client secrets tab, click + New client secret

  10. Add Description "FuseMetrix Secret" and set Expiry to 24 months

  11. Take note of the Secret Value

  12. Click on API permissions in the left menu

  13. Click + Add a permission

  14. Choose Microsoft Graph (the big section at the top)

  15. Click Application permissions*

  16. Type Mail in search box

  17. Select Mail to open options

  18. Check against Mail.Read, Mail.ReadBasic, Mail.ReadBasic.All, Mail.ReadWrite and Mail.Send

  19. Click Add permissions button

  20. Click the Grant admin consent for "your company name"

  21. Keep note of your Primary domain, Client Id and Client Secret obtained above.

Please make sure to set Application permissions rather than Delegate permissions.

The application one enables us to read all mailboxes.

FuseMetrix Setup

  1. Click on Booking Dashboard

  2. Go to Integration Settings

  3. Choose Microsoft GraphAPI

  4. Enter your Tenant ID, App ID, and Client Secret

  5. Click Save

  6. Click the “Test Graph API credentials” to confirm that we are able to access Office 365.

  7. In the Human Resources list, select a user to setup mail access for.

  8. Click Edit

  9. Under Mailboxes Checked by FuseMetrix, tick 'Add new mailbox' and enter the email address and password

  10. Ensure emails are set to never be deleted from the server

  11. Click Save

Did this answer your question?

Related Articles