Configure an incoming link

Still need help?

The Atlassian Community is here for you.

Ask the community

When you configure an incoming link with an external application, you allow this application to access Bitbucket data, which means that Bitbucket acts as the OAuth provider. To learn more about the type of links and additional details, see Link to other applications.

To create an incoming link:

  1. Go to Administration > Applications > Application links.

  2. Select Create link.

  3. Select External application, and then choose Incoming as the direction.

  4. Fill in the details as described in the sections below.

In this type of link, you only need to provide the Redirect URL (also known as Callback URL) from your external application. After authorizing the application, the user will be redirected to this URL with the authorization code.

Select permissions the application can have on your instance. You can choose the following permission scopes:

AccountRepositoriesProjectsAdminSystem admin
  • Write
  • Read
  • Write
  • Admin
  • Admin
  • Write
  • Write

Note that even if you grant higher permissions, the application won’t be able to do more than the user authorizing it. For more info on what each of these scopes do, see OAuth 2.0 scopes for incoming links.

After providing the Redirect URL and selecting the scopes, Bitbucket will generate the OAuth credentials that include these details. You need to copy the credentials to your external application to complete the link.

At this point, the application link has already been created in Bitbucket. You can view its details in Application links, including the OAuth credentials in case you needed to access them later.

If you lose your OAuth credentials, you can access them any time in the details of the application link you created.

To view OAuth credentials:

  1. Go to Administration > Application links.

  2. Find the application link you’re interested in, and select More actions > View credentials.

Last modified on May 31, 2023

Was this helpful?

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