Skip to main content
Skip table of contents

Admin resources: Microsoft Teams Jira Connector - Getting started

Follow on this guide to install and setup Microsoft Teams Jira Connector and the companion Microsoft Teams Bot.

This guide will show you how to set up Microsoft Teams Jira Connector for the first time. This service has two components - the Microsoft Teams App and the Jira App.

General setup process

  1. You need to have installed the Microsoft Teams Jira Connector application in Jira.

  2. You need to have installed the Jira Connector application in Microsoft Teams.

  3. Microsoft Teams administrator needs to consent permissions for Microsoft Teams Jira Connector to allow it to perform the operations it needs to perform. This link can be used to consent. The same link is available on the Jira System settings page.

  4. After you have installed the 2 apps above, the Jira admin needs to connect Microsoft Teams and Jira (let’s call it tenant mapping). Where you will say your Microsoft tenant is linked to your Atlassian Jira tenant. Using connect jira command in Microsoft Teams.

  5. When the tenants are mapped, any Microsoft Teams user can map his or her account to the corresponding Atlassian Jira account. This is done using connect command in Microsoft Teams.

  6. Consent to the Microsoft Teams Jira Connector app to allow interaction with Microsoft Graph API for your organization. This is required to create issue discussion channels.

Tenant mapping

When both apps are installed, Jira administrator needs to follow these steps.

Demo video:

  1. Navigate to the Microsoft Teams page in system settings and find their Bot Connection Token (at the bottom of the page).

    2. Afterwards, open a one on one conversation with Jira Connector in Microsoft Teams and type connect jira. Please enter the corresponding token and press Connect Jira button.

    3. Connect your tenant and user by clicking the Connect button on the card. You will be redirected to your Jira instance where you need to click the only available button to map your accounts.

    4. When this is done the Microsoft Teams card should update to the following.

User mapping

User mapping is very similar process (for Jira admin it is done during the tenant mapping and explained above).

Demo video:

To map your Microsoft Teams and Atlassian Jira accounts you need to type connect in one on one conversation with the Microsoft Teams Jira Connector bot.

When you press Connect button on the card you will end up in your Jira where you need to confirm the account mapping.

When the connection process is done the page should update to

and you should see a card similar to this one

When everything is connected you can move work forward with Microsoft Teams Jira Connector. The best way to start is to search for an issue using free text or JQL search.

In order to allow the Microsoft Teams Jira Connector app to create channels to discuss Jira issues, the Microsoft Teams administrator needs to consent to the required permissions.

The consent process started by clicking on the consent link on the configuration or issue page.

Or you can use this link.


If you don’t have permission to consent you will see the following message, so you need to help your Microsoft Teams admin to consent.

Get help

If you need help please do not hesitate to contact us.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.