Bitbucket OAuth 2.0 (Legacy) connector profile – StackOne setup guide

Sign in to your Bitbucket account.

• Select your avatar/profile from the top navigation
• Choose your workspace from Recent workspaces or All workspaces
• Click the Settings cog icon
• Select Workspace settings from the dropdown

In the left sidebar, expand the Apps and features section, then click OAuth consumers.

Click the Add consumer button to create a new OAuth application.

• Name: Enter a unique name (e.g., StackOne Integration)
• Description: Optional description of the integration
• Callback URL: Enter https://api.stackone.com/connect/oauth2/bitbucket/callback
• URL: Optional link to your application

Select the required OAuth permissions for your integration based on which Bitbucket resources you need to access. Permissions are configured on the OAuth consumer and cannot be changed per authorization request.

• Account (Required): Read permission is required for the connection. Selecting Account Read automatically enables Account Email as a dependency. Write is optional (modify account properties).
• Projects: Read (view projects and repositories), Admin (full admin access)
• Repositories: Read, Write, Admin (view/edit permissions, deploy keys), Delete
• Pull requests: Read (view pull requests), Write (create, merge, and decline pull requests)
• Pipelines: Read (view pipelines and environments), Write (stop, rerun, trigger), Edit variables (create pipeline variables)
• Select only the permissions required for your specific integration needs

Click Save to create the OAuth consumer. After saving, you will be redirected to the OAuth consumers list.

• Click the chevron arrow (›) next to your consumer name to expand and reveal the credentials
• The Key is your Client ID
• The Secret is your Client Secret
• Copy both values and store them securely for use later