Bitbucket

What’s Supported

Supported Actions

This connector supports:

• Read Actions, including full historic backfill. Please note that incremental read is supported for repositories only. For all other objects, a full read of the Bitbucket instance will be done for each scheduled read.
• Write Actions.
• Proxy Actions, using the base URL https://api.bitbucket.org.

Supported Objects

The Bitbucket connector supports reading from the following objects:

• addon/linkers
• pipelines-config/variables
• repositories
• user/emails
• hook_events
• hooks
• members
• projects

The Bitbucket connector supports writing to the following objects:

• pipelines-config/variables

• projects

• snippets

• hooks

Example integration

For an example manifest file of an Apollo integration, visit our samples repo on Github.

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.