High Issue Summary
- API tokens don't seem to be compatible with Sourcetree
- We are deprecating App Password and replacing it with API Token in June 2026, so the ability to authenticate with API token is necessary:
https://www.atlassian.com/blog/bitbucket/bitbucket-cloud-transitions-to-api-tokens-enhancing-security-with-app-password-deprecation
Steps to Reproduce
- Attempt to configure API Token in Settings > Accounts under either Basic Auth or API Token and click Save
Expected Results
- The API token is used successful for auth with Sourcetree
Actual Results
- Using API Token as the auth type requires email (which is incorrect) and does not let you click Save
- Using Basic Auth as the auth type instead with your Bitbucket Cloud username as the username and the API Token as the password fails to authenticate with Login error: We couldn't connect to Bitbucket Cloud with your credentials
- The format for URL's should be either of the following:
https://username:APIToken@bitbucket.org/workspaceID/reposlug.git https://x-bitbucket-api-token-auth:APIToken@bitbucket.org/workspaceID/reposlug.git
- Performing a git clone outside of Sourcetree (eg using a terminal) with either of the above URL formats works without issues
Workaround
- Use OAuth to connect your account, or use AppPassword up until the deprecation date
- Alternatively, you can use a terminal to work with GIT
