Skip to main content
Use this path when you use Overcut’s managed service (Overcut Cloud) and your Bitbucket is Atlassian-hosted Bitbucket Cloud (bitbucket.org). You install the Overcut Forge app; there are no credentials to manage.
Not your setup? See Which setup do I need? to choose between Overcut Cloud, self-hosted Overcut, and Bitbucket Server / Data Center.

​
Prerequisites

  • A Bitbucket Cloud workspace
  • Admin permissions in your Bitbucket workspace
  • An active Overcut Cloud workspace

​
Connect

1

Start Bitbucket Connection

In your Overcut workspace, go to Integrations and click Connect Bitbucket.
2

Install the Overcut App in Bitbucket

Click Install Overcut App to be redirected to your Bitbucket workspace. Install the app and grant the necessary permissions. If you’ve already installed the app, click I’ve Installed the App to proceed.
3

Complete the Setup

After installing the app, you’ll be prompted to enter your Bitbucket workspace name (e.g., my-org). Enter your workspace name and click Complete Install to finalize the connection.
The Forge app manages authentication, permissions, and event delivery for you. There is no OAuth consumer to create, no callback URL to configure, and no webhook to register.

​
Permissions

The Overcut Forge app requests access to your repositories, pull requests, and pipelines, and the ability to manage webhooks. You grant these when you install the app.

​
Troubleshooting

  • App not installed: complete the Marketplace install in Bitbucket first, then click I’ve Installed the App in Overcut.
  • Wrong workspace name: make sure the workspace name you enter matches your workspace slug exactly (for example my-org).
  • Missing repositories: the integration only shows repositories the app can access. Check the app’s grant in your workspace settings.
For concepts shared across all Bitbucket setups (pull request operations, webhook behavior, ticket links), see the Bitbucket overview.