Connect with Bitbucket Cloud

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

Note: 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.

Go to https://bitbucket.org/ and sign in.
Click Settings → Personal Bitbucket settings → App passwords.
Click Create app password.
Tip:
Here's a shortcut if you want to save some clicks.
Give the app password a name.
Choose the following scopes/permissions for the token:
- Account
  - Email
  - Read
- Workspace membership
  - Read
- Projects
  - Read
- Repositories
  - Read
  - Write
- Pull requests
  - Read
- Pipelines
  - Read
Click Create.
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.

Go to https://bitbucket.org/your-project-name/workspace/settings/api
Click Add Consumer.
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.
Choose the following scopes/permissions for the application:
- Account
  - read
- Workspace membership
  - read
Click Save.
Take note of the Client ID and Client Secret values.