Bitbucket

Bitbucket is a web based hosting service for projects that use GIT revision control.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Microsoft
URL	Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support

Connector Metadata
Publisher	Microsoft
Website	https://bitbucket.org/
Privacy policy	https://www.atlassian.com/legal/privacy-policy

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds
Frequency of trigger polls	1	30 seconds

Actions

Approve pull request	This operation is used to approve an existing pull request.
Create issue	This operation creates a new issue in the given repository.
Decline pull request	This operation is used to decline an existing pull request.
Get issue by id	This operation retrieves all information about the given issue.
Get user by Id	This operation returns all information about a given user by its id.
Merge pull request	This operation can merge a given pull request.

Approve pull request

Operation ID:

ApprovePullRequest

This operation is used to approve an existing pull request.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository
Pull Request Id	pullrequestId	True	string	The Id of the pull request.

Returns

Body

ApprovePullRequestResponse

Create issue

Operation ID:

CreateIssue

This operation creates a new issue in the given repository.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository
Issue Title	title	True	string
Description	raw		string
Issue Type	kind	True	string
Priority	priority	True	string	The priority category of the issue.
Status	status		string
Component	name		string	Pre-defined component value.
Milestone	name		string	Pre-defined milestone value.
Version	name		string	Pre-defined version value.

Returns

Body

IssueResponse

Decline pull request

Operation ID:

DeclinePullRequest

This operation is used to decline an existing pull request.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository
Pull Request Id	pullrequestId	True	string	The Id of the pull request.

Returns

Body

DeclineOrMergePullRequestResponse

Get issue by id

Operation ID:

GetIssueById

This operation retrieves all information about the given issue.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository
Issue Id	issueId	True	string	The id of the issue.

Returns

Body

IssueResponse

Get user by Id

Operation ID:

GetUserById

This operation returns all information about a given user by its id.

Parameters

Name	Key	Required	Type	Description
User Id	userId	True	string	The id of the user.

Returns

Body

UserResponse

Merge pull request

Operation ID:

MergePullRequest

This operation can merge a given pull request.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository
Pull Request Id	pullrequestId	True	string	The Id of the pull request.

Returns

Body

DeclineOrMergePullRequestResponse

Triggers

When a new commit is pushed	Triggers when a new commit is pushed to the given repository.
When a new issue is added	Triggers when a new issue is added to the given repository.
When a pull request is approved	Triggers when a pullreqest is approved in the specified repository.
When a pull request is created	Triggers when a new pullreqest is created in the given repository.
When a pull request is declined	Triggers when an existing pullreqest is declined in the given repository.
When a pull request is merged	Triggers when an existing pullreqest is merged in the given repository.
When a repository is added	Triggers when a new repository is created for the authenticated account.
When an issue is updated	Triggers when an issue is updated in the given repository.

When a new commit is pushed

Operation ID:

CreateHookRepositoryPush

Triggers when a new commit is pushed to the given repository.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository

Returns

Body

WebhookRepositoryPushResponse

When a new issue is added

Operation ID:

CreateHookIssueCreated

Triggers when a new issue is added to the given repository.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository

Returns

Body

WebhookIssueCreatedResponse

When a pull request is approved

Operation ID:

CreateHookPullRequestApproved

Triggers when a pullreqest is approved in the specified repository.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository

Returns

Body

WebhookPullRequestApprovedResponse

When a pull request is created

Operation ID:

CreateHookPullRequestCreated

Triggers when a new pullreqest is created in the given repository.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository

Returns

Body

WebhookPullRequestCreatedResponse

When a pull request is declined

Operation ID:

CreateHookPullRequestDeclined

Triggers when an existing pullreqest is declined in the given repository.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository

Returns

Body

WebhookPullRequestDeclinedResponse

When a pull request is merged

Operation ID:

CreateHookPullRequestMerged

Triggers when an existing pullreqest is merged in the given repository.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository

Returns

Body

WebhookPullRequestMergedResponse

When a repository is added

Operation ID:

OnNewRepo

Triggers when a new repository is created for the authenticated account.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name

Returns

Body

List_repositories_Response

When an issue is updated

Operation ID:

CreateHookIssueUpdated

Triggers when an issue is updated in the given repository.

Parameters

Name	Key	Required	Type	Description
Account Name	account	True	string	Atlassian account or team name
Repository Id	slug	True	string	Bitbucket repository

Returns

Body

WebhookIssueUpdatedResponse

Definitions

WebhookIssueCreatedResponse

Name	Path	Type	Description
Actor	actor	Actor
issue	issue	Issue
Repository	repository	Repository

WebhookIssueUpdatedResponse

Name	Path	Type	Description
Actor	actor	Actor
changes	changes	Changes
Comment	comment	Comment
issue	issue	Issue
Repository	repository	Repository

WebhookPullRequestApprovedResponse

Name	Path	Type	Description
Approval	approval	Approval
Actor	actor	Actor
PR	pullrequest	PullRequest
Repository	repository	Repository

WebhookPullRequestCreatedResponse

Name	Path	Type	Description
Actor	actor	Actor
PR	pullrequest	PullRequest
Repository	repository	Repository

WebhookPullRequestDeclinedResponse

Name	Path	Type	Description
Actor	actor	Actor
PR	pullrequest	PullRequest
Repository	repository	Repository

WebhookPullRequestMergedResponse

Name	Path	Type	Description
Actor	actor	Actor
PR	pullrequest	PullRequest
Repository	repository	Repository

WebhookRepositoryPushResponse

Name	Path	Type	Description
Actor	actor	Actor
Push	push	Push
Repository	repository	Repository

List_repositories_Response

Name	Path	Type	Description
values	values	array of object	values
SCM	values.scm	string	Source control manager for the repository.
Website	values.website	string	Url of the website if defined.
Has Wiki	values.has_wiki	boolean	True if the repository has a wiki.
Name	values.name	string	Repository's name.
Fork Policy	values.fork_policy	string	Allow forks, no public forks or no forks.
UUID	values.uuid	string	Repository's immutable id.
Language	values.language	string	Programming language used in the repository.
Created Date-Time	values.created_on	date-time	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
Has Issue Tracker	values.has_issues	boolean	True if an issue tracker has been set for the repository.
Username	values.owner.username	string	Username of the repository's owner.
Name	values.owner.display_name	string	Display name of the repository's owner.
UUID	values.owner.uuid	string	Unique identifier of the repository's owner.
Updated Date-Time	values.updated_on	date-time	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
Size	values.size	integer	Integer indicating size of the repository in bytes.
Type	values.type	string	Git or mercurial.
Slug	values.slug	string	Slug used to identify the repository.
Is private	values.is_private	boolean	True if the repository is private.
Description	values.description	string	The repository's description.

ApprovePullRequestResponse

Name	Path	Type	Description
Role	role	string	The role of the pull request.
Type	type	string	The type of the pull request.
Username	user.username	string	The username of the approver.
Name	user.display_name	string	The display name of the approver.
Type	user.type	string	User or team.
UUID	user.uuid	string	The universally unique identifier of the user.
Is approved	approved	boolean	True if the pull request is approved.

DeclineOrMergePullRequestResponse

Name	Path	Type	Description
Description	description	string	Pull request description.
Title	title	string	Pull request title.
Name	destination.branch.name	string	The name of the destination branch.
Hash	destination.commit.hash	string	The SHA1 of the destination branch head.
Name	destination.repository.name	string	The name of the destination branch repository.
UUID	destination.repository.uuid	string	The UUID of the destination branch repository.
Type	destination.repository.type	string	The type of the destination branch repository.
Status	state	string	Pull request status.
Closed By Username	closed_by.username	string	Username of person who closed the PR.
Closed By Name	closed_by.display_name	string	Name of person who closed the PR.
User Type	closed_by.type	string	Closed by a user or team.
UUID	closed_by.uuid	string	Unique identifier of person who closed the PR.
Name	source.branch.name	string	Name of the source branch.
Hash	source.commit.hash	string	The SHA1 of the source branch head.
Name	source.repository.name	string	The name of the source branch repository.
UUID	source.repository.uuid	string	The UUID of the source branch repository.
Type	source.repository.type	string	The type of the source branch repository.
Name	author.display_name	string	The display name of the creator.
Type	author.type	string	The type of the creator.
Username	author.username	string	The username of the creator
UUID	author.uuid	string	The universally unique identifier of the creator.
Created Date-Time	created_on	date-time	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
Reason	reason	string	The reason the pull request is declined (if so).
Updated on	updated_on	string	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
Id	id	integer	The Id of the pull request.
Task Count	task_count	integer	Task count.

IssueResponse

Name	Path	Type	Description
Priority	priority	string	The priority of the issue.
Kind	kind	string	The kind of issue.
type	repository.type	string	The type of the repository.
name	repository.name	string	The name of the repository.
full name	repository.full_name	string	The full name of the repository.
UUID	repository.uuid	string	The Universally Unique Identifier of the repository.
Username	reporter.username	string	The username of the reporter.
Display name	reporter.display_name	string	The display name of the reporter.
Type	reporter.type	string	The type of the reporter.
UUID	reporter.uuid	string	The Universally Unique Identifier of the reporter.
Title	title	string	The title of the issue.
Component	component.name	string	Pre-defined component value.
Votes	votes	integer	The number of votes on the issue.
Watches	watches	integer	The number of watches on the issue.
text	content.raw	string	The description of the issue.
markup	content.markup	string	The description markup of the issue.
html	content.html	string	The description html of the issue.
Assignee	assignee	string	The assigned user of the issue.
Status	state	string	The status of the issue.
Version	version.name	string	A version value defined by the administrator.
Created on	created_on	date-time	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
Milestone	milestone.name	string	Pre-defined milestone value.
Updated on	updated_on	date-time	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
Type	type	string	The type of issue.
Issue Id	id	integer	The Id of the issue.

UserResponse

Name	Path	Type	Description
Username	username	string	The username.
Type	type	string	The user type.
Display Name	display_name	string	The display name of the user.
UUID	uuid	string	The universally unique identifier of the user.

Actor

Name	Path	Type	Description
Name	display_name	string	Full display name of the author.
Type	type	string	User or team.
Username	username	string	Username or team id.
UUID	uuid	string	Unique identifier of the user or team.

Approval

Name	Path	Type	Description
date time	date	string	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
display name	user.display_name	string	The display name of the approver.
type	user.type	string	The type of the approver.
username	user.username	string	The username of the approver.
UUID	user.uuid	string	The universally unique identifier of the approver.

Changes

Name	Path	Type	Description
New Issue	title.new	string	New value for the issue field.
Old Issue	title.old	string	Old value for the issue field.

Comment

Name	Path	Type	Description
Id	id	integer	Id of the comment added.
Parent Id	parent	integer	Id of the parent comment.
Description	content.raw	string	Description of the comment.
Updated Date-Time	updated_on	string	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)	created_on	date-time	created_on

Issue

Name	Path	Type	Description
Title	title	string	Issue title.
Milestone	milestone	string	Stage the issue has reached.
Updated Date-Time	updated_on	date-time	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
Issue Content	content.raw	string	Raw issue discription.
Created Date-Time	created_on	date-time	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
Component	component	string	User defined enumerator value.
Issue Type	type	string	Bug, enhancement,proposal or task.
Id	id	integer	Issue identifier.
Status	state	string	Issue status.
Priority	priority	string	Issue's priority category.
Version	version	string	String containing a version value.
Kind	kind	string	Issue kind as defined in the GUI.

PullRequest

Name	Path	Type	Description
Id	id	integer	Id of the pull request.
Reviewers	reviewers	array of object	List of reviewers on the pull request.
Description	description	string	Description of the pull request.
Name	destination.branch.name	string	The name of the destination branch.
Respository Name	destination.repository.name	string	Name of the repo where issue is created.
UUID	destination.repository.uuid	string	Repository's unique id.
Repository Type	destination.repository.type	string	Type of the repo where issue is created.
Closed Branch	close_source_branch	boolean	Closes the source branch after merge.
Name	author.display_name	string	Display name of the PR author.
Type	author.type	string	User or team.
Username	author.username	string	Username of the PR author.
UUID	author.uuid	string	The universally unique identifier of the author.
Participant	participants	array of object
Role	participants.role	string	Role of the participant.
Display Name	participants.user.display_name	string	Display name of the participant
Type	participants.user.type	string	User or team.
Username	participants.user.username	string	Participant's username.
uuid	participants.user.uuid	string	The universally unique identifier of the user.
Type	participants.type	string	The type of participant.
Name	source.branch.name	string	Name of the source branch.
Hash	source.commit.hash	string	The SHA1 of the source branch head.
name	source.repository.name	string	The name of the source branch repository.
UUID	source.repository.uuid	string	The UUID of the source branch repository.
Type	source.repository.type	string	The type of the source branch repository.
Created Date-Time	created_on	date-time	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
Status	state	string	The status of the pull request.
Reason	reason	string	Reason the pull request is declined (if so).
Updated Date-Time	updated_on	string	yyyy-MM-ddTHH:mm:ss.fff(+hh:mm or -hh:mm)
Title	title	string	The name of the pull request.

Push

Name	Path	Type	Description
changes	changes	array of object	changes
created	changes.created	boolean	Indicate whether the reference is new.
type	changes.old.type	string	type
raw	changes.old.target.author.raw	string	raw
date	changes.old.target.date	date-time	date
message	changes.old.target.message	string	message
hash	changes.old.target.hash	string	hash
type	changes.old.target.type	string	type
parents	changes.old.target.parents	array of object	parents
type	changes.old.target.parents.type	string	type
href	changes.old.target.parents.links.html.href	string	href
href	changes.old.target.parents.links.self.href	string	href
hash	changes.old.target.parents.hash	string	hash
href	changes.old.target.links.html.href	string	href
href	changes.old.target.links.self.href	string	href
name	changes.old.name	string	name
href	changes.old.links.commits.href	string	href
href	changes.old.links.html.href	string	href
href	changes.old.links.self.href	string	href
type	changes.new.type	string	type
raw	changes.new.target.author.raw	string	raw
date	changes.new.target.date	date-time	date
message	changes.new.target.message	string	message
hash	changes.new.target.hash	string	hash
type	changes.new.target.type	string	type
parents	changes.new.target.parents	array of object	parents
type	changes.new.target.parents.type	string	type
href	changes.new.target.parents.links.html.href	string	href
href	changes.new.target.parents.links.self.href	string	href
hash	changes.new.target.parents.hash	string	hash
href	changes.new.target.links.html.href	string	href
href	changes.new.target.links.self.href	string	href
name	changes.new.name	string	name
href	changes.new.links.commits.href	string	href
href	changes.new.links.html.href	string	href
href	changes.new.links.self.href	string	href
truncated	changes.truncated	boolean	Indicate whether Bitbucket truncated the commits array in this payload.
closed	changes.closed	boolean	Indicate whether the reference is old.
commits	changes.commits	array of object	commits
raw	changes.commits.author.raw	string	raw
date	changes.commits.date	date-time	date
message	changes.commits.message	string	message
hash	changes.commits.hash	string	hash
type	changes.commits.type	string	type
parents	changes.commits.parents	array of object	parents
type	changes.commits.parents.type	string	type
href	changes.commits.parents.links.html.href	string	href
href	changes.commits.parents.links.self.href	string	href
hash	changes.commits.parents.hash	string	hash
forced	changes.forced	boolean	Indicate whether the push was forced.

Repository

Name	Path	Type	Description
display name	owner.display_name	string	The display name of the owner.
type	owner.type	string	The type of owner.
username	owner.username	string	The username of the owner.
UUID	owner.uuid	string	The universally unique identifier of the owner.
name	name	string	The name of the repository.
SCM	scm	string	The source control manager of the repository.
website	website	string	The website of the repository.
UUID	uuid	string	The universally unique identifier of the repository.
full name	full_name	string	The full name of the repository.
is private	is_private	boolean	A boolean indicating if the repository is private.
type	type	string	The type of the repository.