Bitbucket

The Bitbucket integration allows you to connect your Bitbucket workspace to Harmony and automate user provisioning as part of your onboarding workflows. Once connected via OAuth, Harmony agents can manage repository access and workspace membership automatically - no manual steps required.

This integration is ideal for engineering onboarding flows where new hires need to be added to your Atlassian organization and granted access to the right repositories from day one.

Connecting Bitbucket

To connect Bitbucket as a SaaS integration:

1. In Harmony, navigate to Integrations and select SaaS Applications.
2. Find Bitbucket in the list and click Connect.
3. You will be redirected to Atlassian to authorize the connection via OAuth.
4. Grant the requested permissions and confirm the authorization.
5. Once authorized, Bitbucket will appear as a connected integration and will be available to use in your workflows.

Available Actions

After connecting Bitbucket, the following actions are available to use in your onboarding workflows:

Invite User

Adds a new user to your Atlassian organization. Use this action at the start of an onboarding flow to give a new team member access to your organization before assigning them to specific repositories.

Set Repository Permission

Grants a user access to a specific repository at a defined permission level. Use this action to provision the exact level of access a new hire needs - for example, read access for internal documentation repos or write access for active development repos.

Remove Repository Permission

Revokes a user's access to a specific repository. Use this action in offboarding flows or when adjusting access as roles change.

List Workspaces

Retrieves a list of workspaces available in your connected Bitbucket account. Use this action to dynamically reference workspace details within your workflow logic.

Using Bitbucket Actions in Workflows

Once Bitbucket is connected, its actions are available in the workflow builder alongside other SaaS integration actions. You can combine them with actions from other integrations - such as sending a Slack message or creating a ticket in Jira - to build end-to-end onboarding automations.

A typical onboarding workflow with Bitbucket might look like this:

1. A new hire record is created in your HRIS.
2. Harmony triggers the onboarding workflow automatically.
3. The Invite User action adds the new hire to your Atlassian organization.
4. The Set Repository Permission action grants access to the relevant repositories based on their team or role.
5. A confirmation message is sent to the manager via Slack.

Permissions and OAuth Scope

The Bitbucket integration uses OAuth to authenticate and operates with the permissions granted during the authorization flow. Make sure the account used to authorize the integration has sufficient administrative access in your Atlassian organization to perform the actions you plan to automate - such as inviting users and managing repository permissions.

Disconnecting Bitbucket

To disconnect the Bitbucket integration:

1. Navigate to Integrations and select SaaS Applications.
2. Find Bitbucket in the list and click on the connected integration.
3. Select Disconnect and confirm your choice.

Disconnecting Bitbucket will stop all associated workflow actions from executing. Any workflows that include Bitbucket actions should be reviewed and updated before disconnecting.