Link to other applications

Still need help?

The Atlassian Community is here for you.

Ask the community

Application links (sometimes called app links) allow you to set up links, share information, and provide access to certain resources or functionality across multiple Atlassian products. Linking Jira to other applications allows you to include information from these systems in Jira projects and issues.

For example, if you link Jira to Confluence, you can include pointers to wiki pages when creating or editing issues. Another common use case is to link Bitbucket Server with Jira; this allows you to view branches, commits, and pull requests that correspond to your Jira issues. In addition to Atlassian products, you can also link to external applications – for example, you can use an app that allows you to share ZenDesk or Salesforce data via an application link.

To view application links:

  1. Go to Administration > Applications.

  2. Select Application links. You’ll see the following page: 

  1. Application: Name of the linked application and its version. For external applications, it always shows Generic application.

  2. Direction: Communication direction, either Incoming, Outgoing, or Two-way. For Atlassian products, you should configure two-way communication, but some external applications won’t need it.

  3. Status: Connection status. For external applications, it always shows Non-Atlassian.

  4. Actions: Actions you can do on your links.

    1. Go to remote – open the full application link configuration.
    2. Make primary – specify a default instance if you have multiple links to the same type of application (for example, to multiple Jira servers).
    3. Delete – remove an application link from Jira.
    4. For OAuth 2.0 connections, you can additionally view your OAuth credentials.

Link to Atlassian products or external applications using OAuth 1.0

When you link to other Atlassian products, the communication is using OAuth 1.0.

tip/resting Created with Sketch.

You can also use this option to link to external applications using OAuth 1.0 – we've kept this option for users who can't upgrade their integrations to use OAuth 2.0.

To link to other Atlassian products or external applications using OAuth 1.0:

  1. In application links, select Create link.

  2. Select Atlassian product as the link type.

  3. Enter the URL of your Atlassian product or external application.

  4. Follow the steps in the wizard. You’ll be redirected between Jira and the product you’re linking to to authorize the two-way connection.

Link to external applications using OAuth 2.0

You can link Jira to external applications using OAuth 2.0 in both directions, either making Jira act as a client (outgoing link) or provider (incoming link).

Configure Jira as an OAuth 2.0 client (outgoing link)

In this scenario, Jira acts as an OAuth client, requesting data from the external application.

Choose when:

  • You need to configure integrations with external email providers, such as Google or Microsoft so your users can create issues and comments from emails.

  • You want to use DVCS accounts to integrate GitLab with development tools.

For more information, see Configure an outgoing link.

Configure Jira as an OAuth 2.0 provider (incoming link)

In this scenario, Jira acts as an OAuth provider, allowing the external application to access its data.

Choose when:

  • You have internal integrations that are currently using OAuth 1.0 and want to update them to OAuth 2.0 for better security. We’ve included details about our OAuth 2.0 implementation to help you achieve that.

For more information, see Configure an incoming link.

To add Microsoft as a new provider, you should have an OAuth key and secret from Microsoft Azure. Learn how to generate them

Last modified on Mar 10, 2023

Was this helpful?

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