Onit Documentation

Azure App Registration for Outlook Add-In

by Shehzad Ahmad Updated on

The Email Attaching functionality in the Outlook Add-In requires certain mailbox permissions to be functional. This guide will walk you through how to setup an Azure App in order to grant those permissions.

1. Register a new Azure App

Go to your Azure tenant and create a new Azure App. The Display name can be anything that will help you identify it is for the Onit Outlook Add-In.

2. Add a Redirect URI

If not already added during the App creation, go to Authentication and add a Redirect URI.

For production environments the format will be https://[subdomain].onit.com/o365/taskpane.html

For UAT enviornments the format will be https://[subdomain].gold-ab.onit.com/o365/taskpane.html

3. Add Permissions

Go to API Permissions and add the following permissions:

  • User.Read
  • Mail.Read
  • Mail.Send

4. Add the Azure App Client ID to Onit Connfiguration

Copy the Client ID from the Azure App Overview and paste it in the Client ID field in Onit - Administration > Extensions > Outlook Extension (Your name might be different).

You're all set!

Note: Outlook will prompt the user to log into their account when forwarding emails through the Add-In in order to verify the use of the permission. This should be just once per Outlook Add-In session. 

© 2024 Onit, Inc.

docs.onit.com contains proprietary and confidential information owned by Onit, Inc. that is subject to copyright. Onit presents it exclusively to you for your sole use in conjunction with using Onit products. No portion of the materials contained herein may be used for any other purpose. No portion of the materials contained herein may be shared with third parties or reproduced in any form.