Setting up an email channel with the Microsoft Graph API protocol

Still need help?

The Atlassian Community is here for you.

Ask the community

Your customers can send request to your queues from the comfort of their own mailbox. To receive their emails and have them turned into requests in Jira Service Management, you need to set up an email channel. One of the protocols that you can choose from is Microsoft Graph API. To use this protocol, there are a few steps that you need to take.

In Jira Service Management 5.8, Microsoft Graph API can only be used for incoming email.

Since Microsoft Graph API is based on OAuth 2.0, before you start setting up the email channel, you need to configure your Azure Active Directory integration and add an application link in Jira Service Management. Learn how to configure OAuth 2.0 integration with Microsoft Azure.

To use Microsoft Graph API for incoming email, you need to add the following permissions to your API permissions in your Azure Active Directory app registry:

  • Mail.ReadWrite
  • offline_access
  • Mail.ReadWrite.Shared (for shared mailboxes only)

You also need to add the following URLs to the Scopes section in the application link configuration in Jira:
https://graph.microsoft.com/Mail.ReadWrite
https://graph.microsoft.com/offline_access
https://graph.microsoft.com/Mail.ReadWrite.Shared (for shared mailboxes only)

To configure application links, you must be logged in as a user with the Jira Administrators or Jira System Administrators global permission.

API permissions in Microsoft Azure

Application link configuration in Jira Service Management

Once your Azure Active Directory integration and Jira Service Management application link are ready, you can proceed to adding the email channel.

  1. Go to Project Settings > Email requests and create a new channel.

  2. Select Microsoft as the Email service provider and Microsoft Graph API as the Email protocol.

  3. Enter your email address and select the application link you configured as the authentication method.

Email channel configuration—selecting the authentication method 

Creating a new email channel—selecting the email protocol 

4.  After you select Save , you’ll be redirected to the Microsoft authorization page. Log in and give Jira the required permissions. Once that’s done, you’ll be taken back to the Email requests page in your project settings.

Jira Service Management will test the connection with the newly created Microsoft Graph API email channel and pull the first emails. To see the status of this process, select Actions Actions button  > View log next to the new email channel on the Email requests page in your project settings.

The status of a connection to an email channel in the connectivity log

Jira Service Management pulls unread emails from the mailbox once a minute. After a message is processed, it’s marked as read. This is done to distinguish between new and old messages. To see what has been processed in your email channel, select Actions Actions button  > View log next to the channel on the Email requests page in your project settings.

The status of processed emails in the processing log

Last modified on Jul 21, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.