Skip to main content

Connect with Bitbucket DC

The integration with Bitbucket DC allows you to sync repositories to Venue.sh as entities.

Prerequisites
  • An organization in Venue.sh
  • A role of Owner or above
  • A Bitbucket DC account with an appropriate permission level

Creating a Personal Access Token​

note

Bitbucket's documentation on creating personal access tokens describes the process in detail. While we endeavour to keep this document current, Bitbucket's process may have changed.

  1. Sign in to your hosted instance of Bitbucket DC.

  2. Click your profile pic, then select Manage account > HTTP access tokens > Create token.

  3. Set a token name.

  4. Choose the following scopes/permissions for the token:

    • Project permissions
      • Project write
    • Repository permissions
      • Repository write

  5. Click Create.

  6. Take note of the personal access token as it cannot be retrieved once you leave the page.

Creating an OAuth app​

To fully integrate Bitbucket with Venue.sh, you must set up an OAuth app.

  1. Sign in to your hosted instance of Bitbucket DC.

  2. Go to Administration > Applications > Application links.

  3. Select Create link.

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

  5. Insert the following properties:

    • Application name: Venue.sh
    • Callback URL: https://<organization>.venue.sh/api/auth/bitbucket
tip

Your organizations Callback URL can be found in app when adding a Bitbucket DC connection on the right sidebar.

  1. Choose the following scopes/permissions for the application:

    • Projects
      • Admin
    • Repositories
      • Read
      • Write

  2. Click Save.

  3. Take note of the Client ID and Client Secret values.