Bamboo Integration with Bitbucket Cloud: Utilizing API Tokens for Repository Configuration

[#1]

Bitbucket Cloud is deprecating app passwords in favor of API tokens to enhance security and provide better management controls. After September 9, 2025, users will no longer be able to create new app passwords in Bitbucket Cloud, and by June 9, 2026, all existing app passwords will stop working.

To address the need for API token authentication, Bamboo now supports this feature starting from versions 10.2.7, 11.0.4, and 9.6.16. Upgrading to any of these versions enables you to create repositories using API tokens, while still maintaining compatibility with existing repositories created using App Passwords.

How to create Bamboo Bitbucket Cloud repositories with API token

Follow these steps to create API token and configure a Bamboo Bitbucket Cloud repository:

Please note below steps are applicable for Bamboo versions 10.2.7, 11.0.4, 9.6.16 or later.

1. From the top navigation bar of Bitbucket Cloud account, select Settings > Atlassian account settings > Security.

2. Choose Create and manage API tokens > Create API token with scopes.

3. Name the token, set an expiry date, and select Bitbucket as the app.

4. Assign necessary permissions (see Bitbucket API token permissions for details).

5. Create the token, copy it, and paste it into your Bamboo application Bitbucket cloud repository credentials. Ensure you use your email address (the one associated with the API token creation) as your username. Note: The token is displayed only once.

Learn more on how to create API tokens in our documentation.

Next steps

• Upgrade to Bamboo versions 10.2.7, 11.0.4, 9.6.16.

• Review app passwords: No changes are happening now, and existing integrations remain unaffected until June 9, 2026. However check Bitbucket personal settings for existing app passwords, which will stop working on June 9, 2026, and prepare for upcoming changes.

• Review your existing Bitbucket Cloud repositories: Please check the KB article Bitbucket Cloud Repository Configuration Fails in Bamboo with API Tokens to retrieve the repositories that need to be updated to use API tokens.

• Start updating to API tokens: Begin integrating API tokens in your environment to ensure compatibility with your workflows.

• Stay informed: Monitor our communications for updates, including reminders and additional resources to support your transition.

If you are facing errors while using API token in repository configuration Bamboo versions before 10.2.7, 11.0.4, and 9.6.16 please check this KB article Bitbucket Cloud Repository Configuration Fails in Bamboo with API Tokens for solutions.