Overview
Bitbucket is Atlassian's Git hosting + CI/CD platform – Atlassian's GitHub equivalent, tightly integrated with Jira. The Automize Bitbucket connector covers repositories, branches, commits, pull requests, and pipelines.
- Regions: Bitbucket Cloud is global – api.bitbucket.org. Bitbucket Data Center (self-hosted) uses a different API (Stash REST) – separate config. Connector targets Cloud.
- Plans: Free, Standard, Premium – all expose the API. Premium adds enforced merge checks, IP allow lists, advanced security.
Setting up the connection
Auth type: Bearer Token.
- Sign in to Bitbucket → Personal Settings → App passwords → Create.
- Select scopes (repository read/write, pull requests read/write, pipelines read).
- Copy the app password.
- In Automize, open Settings → Connectors → Bitbucket → Add connection. Use your Bitbucket username + app password as the bearer token (the connector may concatenate them as username:app_password).
Find your credentials at https://bitbucket.org/account/settings/app-passwords/.
Rate limits
Bitbucket enforces 1,000 requests/hour per user. Higher with OAuth flow via team apps. Connector retries 429 with Retry-After.
Data model
Workspace ─┬─ Projects (optional grouping)
└─ Repositories ─┬─ Branches ─── Commits
├─ Pull Requests ─── Comments + Reviews
├─ Pipelines (CI/CD runs)
└─ Webhooks
workspace is the Bitbucket workspace slug (e.g. yourcompany). repo_slug
is the repo's URL slug.Available operations
9 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Create Pull Request | General | Create a pull request |
| Get Pull Request | General | Get PR details |
| Get Repo | General | Get repository details |
| List Branches | General | List branches |
| List Commits | General | List commits |
| List Pipelines | General | List CI/CD pipelines |
| List Pull Requests | General | List pull requests |
| List Repos | General | List repositories for a workspace |
| Trigger Pipeline | General | Trigger a pipeline run |
Operations
Create Pull Request
Create a pull request
| Parameter | Required | Type | Description |
|---|---|---|---|
Workspace workspace | Yes | text | |
Repo Slug repo_slug | Yes | text | |
Title title | Yes | text | |
Source source | Yes | text | |
Destination destination | Yes | text | |
Description description | Yes | text |
Tips
- title + source.branch.name + destination.branch.name.
- description in Markdown. reviewers[]: usernames of reviewers to assign.
Get Pull Request
Get PR details
| Parameter | Required | Type | Description |
|---|---|---|---|
Workspace workspace | Yes | text | |
Repo Slug repo_slug | Yes | text | |
Pr Id pr_id | Yes | text |
Tips
- Returns PR + source + destination branches + author + reviewers.
Get Repo
Get repository details
| Parameter | Required | Type | Description |
|---|---|---|---|
Workspace workspace | Yes | text | |
Repo Slug repo_slug | Yes | text |
Tips
- workspace + repo_slug. Returns full repo metadata.
List Branches
List branches
| Parameter | Required | Type | Description |
|---|---|---|---|
Workspace workspace | Yes | text | |
Repo Slug repo_slug | Yes | text |
Tips
- Pages via page. Filter by name.
List Commits
List commits
| Parameter | Required | Type | Description |
|---|---|---|---|
Workspace workspace | Yes | text | |
Repo Slug repo_slug | Yes | text |
Tips
- Page via page. Filter by branch (include=<branch>) and date.
List Pipelines
List CI/CD pipelines
| Parameter | Required | Type | Description |
|---|---|---|---|
Workspace workspace | Yes | text | |
Repo Slug repo_slug | Yes | text |
Tips
- Returns CI/CD runs. Filter by sort, target.ref_name (branch).
List Pull Requests
List pull requests
| Parameter | Required | Type | Description |
|---|---|---|---|
Workspace workspace | Yes | text | |
Repo Slug repo_slug | Yes | text |
Tips
- Filter by state (OPEN, MERGED, DECLINED, SUPERSEDED).
- Multiple states: state=OPEN&state=MERGED.
List Repos
List repositories for a workspace
| Parameter | Required | Type | Description |
|---|---|---|---|
Workspace workspace | Yes | text |
Tips
- workspace required. Page via page + pagelen (max 100).
- Filter via q parameter: ?q=name~"foo".
Trigger Pipeline
Trigger a pipeline run
| Parameter | Required | Type | Description |
|---|---|---|---|
Workspace workspace | Yes | text | |
Repo Slug repo_slug | Yes | text | |
Target target | Yes | text |
Tips
- target: {ref_type: 'branch', ref_name: 'main', type: 'pipeline_ref_target'}.
- selector for custom pipelines (defined in bitbucket-pipelines.yml).
FAQ
- Why does my app password fail?
- Bitbucket requires username + app password (basic auth shape). The connector handles this but verify the username is your Bitbucket login name (NOT email). Also verify the app password has the right scopes.
- OAuth 2 vs app password?
- App password is fine for personal automation. OAuth 2 (via a Bitbucket OAuth consumer) is recommended for multi-user/org automation. App passwords don't expire – rotate manually.
- Data Center / Server – same connector?
- No. Server / Data Center uses the Bitbucket REST API (different endpoints + auth). This connector targets Cloud.