Bitbucket Cloud

Read and write Bitbucket Cloud repositories, pull requests, comments, tasks, branches, commit statuses, pipelines and deployments.

Link code review, build results and deployments to tickets, change records and release reporting.

Build a flow with Bitbucket Cloud Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

branches

Create branch
Destination
Duplicate protected
Creates a branch pointing at a commit.
List branches
Source
Open branches with their head commit, most recent first.

commit statuses

List commit statuses
Source
Build statuses reported against a commit.
Report build status
Destination
Duplicate protected
Creates or overwrites the build status with this key on a commit.

commits

List commits
Source
Commits reachable from a branch (or all branches), newest first.

deployments

List deployments
Source
Deployments to environments with state and released commit.

environments

List deployment environments
Source
Deployment environments such as Test, Staging and Production.

pipeline steps

List pipeline steps
Source
Steps in a pipeline with state and timings.

pipelines

Run pipeline
Destination
Not retried automatically
Runs the default or a custom pipeline for a branch, with optional variables.
Get pipeline
Source
One pipeline with state, result and build minutes.
List pipelines
Source
Pipelines run in the repository, newest first.

projects

List projects
Source
Projects in the workspace.

pull request comments

Add pull request comment
Destination
Not retried automatically
Adds a general comment, a reply, or an inline comment on a file line.
List pull request comments
Source
General and inline comments on a pull request.

pull request tasks

Create pull request task
Destination
Not retried automatically
Adds a review task to a pull request, optionally attached to a comment.
List pull request tasks
Source
Review tasks on a pull request with resolution state.

pull requests

Create pull request
Destination
Not retried automatically
Opens a pull request from a branch in this repository.
Get pull request
Source
One pull request with reviewers and participant approvals.
List pull requests
Source
Incremental
Pull requests in a repository ordered by last update; open only unless states are given.
Update pull request
Destination
Duplicate protected
Updates title, description, destination, reviewers or draft state of an open pull request.

repositories

List repositories
Source
Incremental
Repositories in the workspace, most recently updated last.

workspaces

List workspaces
Source
Workspaces the credential can access, with administrator flag.

Authentication

Atlassian account email and API token, or an access token

Plans and access

All Bitbucket Cloud plans. Workspace and repository access tokens need a Premium plan. API tokens act as the Atlassian account and are limited by the scopes chosen at creation; app passwords stopped working on 9 June 2026.

Test environment

A free Bitbucket Cloud workspace works for testing.

Rate limits

Hourly per-user limits per resource type (for example 1,000 requests per hour for most repository data, higher with scaled limits on Standard and Premium); HTTP 429.

Provider events

Repository and workspace webhooks for push, pull request, build status and pipeline events. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

The Bitbucket issue tracker endpoints are no longer in the published Bitbucket Cloud API specification, so issues are not implemented.
Merging, declining and approving pull requests and stopping pipelines are not implemented.
Pull request updated-since filters use Bitbucket query language (BBQL) on updated_on.
Pull request, comment, task and pipeline creates have no idempotency key; uncertain writes are not repeated automatically.