​
What’s Supported

​
Supported Actions

This connector supports:

​
Before You Get Started

To connect Bitbucket with Ampersand, you will need a Bitbucket/Atlassian Account. Once your account is created, you’ll need to create an OAuth consumer in your bitbucket workspace, configure the app, and obtain the following credentials from your app:
  • Client ID
  • Client Secret
You will then use these credentials to connect your application to Ampersand.

​
Create a Bitbucket Account

Follow these steps to sign up for a Bitbucket account:

​
Register a Bitbucket OAuth App

Follow the steps below to register a Bitbucket OAuth app:
  1. Log in to your Bitbucket account.
  2. Go to Workspace Settings by clicking the gear icon in the top-right navigation bar.
  3. Select OAuth consumers from the left sidebar then click Add consumer.
  4. Enter the following details in the create application form:
    1. Name: Enter a name for your app.
    2. Description: Provide a brief description of your app.
    3. Callback URL: Enter the Ampersand redirect URL: https://api.withampersand.com/callbacks/v1/oauth.
  5. Select the permissions you want to grant to your app.
  6. Click Save. Bitbucket Oauth creation
Once your app is created, you can access the Client ID and Client Secret credentials. Note these down, as you will need them to connect your app to Ampersand. Bitbucket Oauth secrets

​
Add Your Bitbucket App Info to Ampersand

  1. Log in to your Ampersand Dashboard.
  2. Select the project where you want to create a Bitbucket integration.\ Ampersand Project Selection
  3. Select Provider Apps.
  4. Select Bitbucket from the Provider list.
  5. Enter the previously obtained Client ID in the Client ID field and the Client Secret in the Client Secret field.
    Ampersand Project Selection
  6. Click Save Changes.