Bitbucket Cloud

In this article, you'll learn how to connect a Bitbucket Cloud workspace to Enjo by creating an OAuth consumer in Bitbucket and completing the integration setup in Enjo.

Before you start

• You need Owner or Admin role in Enjo.

• You need access to your Bitbucket Cloud account with permission to manage workspace settings and create OAuth consumers.

  Watch video

Step 1 — Start the connection in Enjo

1. Go to Settings > Apps.

2. Click Connect Apps.

3. Find Bitbucket Cloud in the list and select it.

4. Click + Add New.

The configuration screen shows the following fields:

• App Name

• Callback URL

• Workspace Name

• Consumer Key

• Consumer Secret

Keep this screen open — you will need the Callback URL when creating the OAuth consumer in Bitbucket.

Step 2 — Create an OAuth consumer in Bitbucket

1. Log in to your Bitbucket Cloud account.

2. Open Settings from the top-right corner and select Workspace Settings.

3. Under Apps and Features, select OAuth consumers.

4. Click Add consumer.

5. Fill in the form:

   • Name — enter a recognisable name, for example "Enjo Integration"

   • Callback URL — paste the exact Callback URL from the Enjo configuration screen

   • Permissions — under Project, enable Read permission

6. Click Save.

⚠️ The Callback URL must match exactly what is shown in Enjo. Any difference will cause the connection to fail.

1. Click the consumer name in the list to reveal its credentials.

2. Copy the Key and Secret.

Step 3 — Enter credentials in Enjo

1. Return to the Enjo configuration screen.

2. Paste the Key into the Consumer Key field.

3. Paste the Secret into the Consumer Secret field.

4. Enter your Workspace Name. Find it in your Bitbucket URL: https://bitbucket.org/{workspace-name}/{repo-name} The workspace name is the segment between bitbucket.org/ and the repository name.

5. Click Next.

Step 4 — Set visibility and connect

1. Enter a name for this connection.

2. Choose the visibility:

   • Workspace — available to all AI Agents in your workspace

   • Specific AI Agents — available only to selected agents

3. Click Connect.

4. When prompted, grant Enjo access to your Bitbucket account to finalise the setup.

Manage the connection

Once connected, the Bitbucket Cloud entry appears under Settings > Apps showing:

• Workspace URL

• Status — Active

• Created by

• Visibility setting

💡 You can update the visibility or delete the connection at any time from Settings > Apps.

What's next

• AI Agent Knowledge — Add Bitbucket data as a knowledge source for your AI Agent.

• Enjo App Integrations — Connect other platforms to your Enjo workspace.

• AI Agent AI Actions — Configure actions your AI Agent can take in connected systems.

• Audit Log — Track integration changes across your workspace.