Bitbucket

Connect your Bitbucket repositories so that Tembo can open pull requests directly in your workspace.

Features

• Automatically sync repositories from your Bitbucket workspaces
• Create and manage pull requests with AI-generated code changes
• Support for both draft and regular pull requests
• Repository selection for targeted automation

Installation

1. Create Service User

   Create a dedicated Bitbucket account for Tembo using either an email alias ([e-mail]) or a dedicated email ([e-mail]). Invite this account to your Bitbucket workspace and complete the sign-up process using the name “Tembo”. This ensures that PRs are opened as “Tembo” rather than your personal account.

2. Connect Integration

   Navigate to the Integrations page in Tembo and click the Install button next to Bitbucket. Make sure you’re logged into the Tembo Bitbucket account (not your personal account) when completing this step.

3. OAuth Authorization

   Complete the OAuth flow to grant Tembo access to your Bitbucket account. This will allow Tembo to:

   • Read your repositories and workspaces
   • Create branches and pull requests
   • Access repository metadata
4. Select Repositories

   After connecting, Tembo will sync all accessible repositories from your Bitbucket workspaces. Choose the repositories you want Tembo to work with, including both your monorepo and docs repositories for full coverage.

   Tip: If repositories don’t appear after a few minutes, use the sync button on the Integrations page to manually trigger a refresh.

Configuration

Repository Settings

Once connected, you can configure which repositories Tembo should monitor:

1. Workspace Selection: Tembo automatically discovers all workspaces your service user has access to
2. Repository Selection: Choose specific repositories from each workspace
3. Default Branch: Tembo will use the repository’s default branch as the base for PRs

Pull Request Settings

Configure how Tembo creates pull requests:

• Draft PRs: Enable to create pull requests as drafts by default
• Branch Cleanup: Pull requests automatically delete source branches when merged
• PR Templates: Use your repository’s existing PR template if configured

Managing Your Integration

Manual Sync

If you’ve added new repositories to your Bitbucket workspace or modified repository permissions, you can manually sync to refresh the list:

1. Navigate to the Integrations page
2. Find the Bitbucket integration card
3. Click the sync button (circular arrow icon)
4. Wait for the sync to complete - the button will show a loading indicator while syncing

The sync process will discover any new repositories you’ve granted access to and update existing repository metadata.

Usage

Automatic Repository Sync

Tembo periodically syncs with your Bitbucket account to discover new repositories and update existing ones. The sync process:

1. Fetches all workspaces accessible to the connected account
2. Lists repositories within each workspace
3. Creates or updates repository records in Tembo
4. Maintains metadata about workspace and repository relationships

Pull Request Creation

When Tembo creates a pull request:

1. Branch Creation: Creates a new branch from the default branch
2. Code Changes: Applies AI-generated changes to the branch
3. PR Creation: Opens a pull request with generated title and description
4. Draft Status: Respects your draft PR settings
5. Source Branch Cleanup: Automatically deletes the source branch when merged

Working with Pull Requests

Note: Tembo doesn’t respond to feedback on pull requests yet for Bitbucket (comments or PR reviews). If having this feature would be valuable to you, please contact [e-mail].

Troubleshooting

Common Issues

Repositories Not Appearing After Installation

If repositories don’t appear in the repository list after installation:

1. Wait a few minutes - Initial sync can take 2-5 minutes depending on the number of repositories
2. Check repository permissions - Ensure the service user has access to the repositories in your Bitbucket workspace
3. Manual sync - Click the sync button on the Bitbucket integration card to refresh the repository list
4. Verify workspace access - Ensure the service user is a member of all required workspaces

Authentication Errors

• Ensure the service user has proper permissions in the Bitbucket workspace
• Check that OAuth tokens haven’t expired (Tembo handles automatic refresh)
• Verify the service user is a member of all required workspaces

Repository Access

• Confirm the service user has read/write access to target repositories
• Check that repositories aren’t archived or have restricted permissions
• Ensure the workspace has the correct access levels configured

Pull Request Creation

• Verify branch protection rules don’t prevent Tembo from creating PRs
• Check that the default branch is correctly configured
• Ensure the repository allows pull requests from the connected account

If you encounter persistent authentication issues, try disconnecting and reconnecting the Bitbucket integration.

Supported Webhooks

Tembo listens to common Bitbucket events and maps them to automation triggers (reference them as bitbucket.<category> in your triggerName, e.g., bitbucket.pull_request.opened). The Integrations page in the app shows the live set enabled for your org. Supported events:

• pull_request.opened
• pull_request.updated
• pull_request.reopened
• pull_request.approved
• pull_request.unapproved
• pull_request.merged
• pull_request.closed
• pull_request.comment_created

See Automations for creating triggers from these events.