Bitbucket

​

What’s Supported

​

Supported Actions

This connector supports:

• Proxy Actions, using the base URL https://api.bitbucket.org.

​

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:

• Go to the Atlassian website and sign up for a new 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.

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.

​

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.
   

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.

   
   

6. Click Save Changes.