Connect with Bitbucket Cloud

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

Prerequisites

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

Creating an app password

note

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

1. Go to https://bitbucket.org/ and sign in.

2. Click Setting > Personal Bitbucket settings > App passwords.

3. Click Create app password.

tip

Here's a shortcut if you want to save some clicks.

4. Give the app password a name.

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

   • Account
     • Email
     • Read
   • Workspace membership
     • Read
   • Projects
     • Read
   • Repositories
     • Read
     • Write
   • Pull requests
     • Read
   • Pipelines
     • Read

6. Click Create.

7. Take note of the app password as it cannot be retrieved once you leave the page.

Creating an OAuth app

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

1. Go to https://bitbucket.org/<your-project-name>/workspace/settings/api

2. Click Add Consumer.

3. 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 Cloud connection on the right sidebar.

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

   • Account
     • read
   • Workspace membership
     • read

5. Click Save.

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