- Integrations
- /
- Bitbucket
- /
- Actions
- /
- Merge Pull Request
ActionBitbucketUpdated May 2026
How do I programmatically merge a Bitbucket PR?
Short answer: Drop the "Bitbucket → Merge Pull Request" action anywhere in your workflow, map the inputs from upstream nodes, and publish.
Inputs
The fields this action accepts.
Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.
| Field | Type | Required | Description |
|---|---|---|---|
Workspace workspace | string | Required | Workspace. Example: my-team |
Repository Slug repo_slug | string | Required | Repository Slug. Example: my-project |
PR ID pr_id | string | Required | PR ID. Example: 42 |
Merge Strategy merge_strategy | options | Optional | Merge Strategy. Options: Merge Commit, Squash, Fast-Forward |
Close Source Branch close_source_branch | options | Optional | Close Source Branch. Options: Yes, No |
Sample request
{"workspace": "e.g. my-team","repo_slug": "e.g. my-project","pr_id": "e.g. 42","merge_strategy": "{{trigger.merge_strategy}}","close_source_branch": "{{trigger.close_source_branch}}"}
Returns
{"id": 42,"state": "MERGED","merge_commit": {"hash": "abc123"}}
Use these fields in downstream nodes for routing, logging, or error handling.
Triggered by
Apps that pair well as the trigger for Merge Pull Request.
Any of these apps can fire this action as part of a workflow.
FAQ
Questions about Merge Pull Request.
What does the Merge Pull Request action do in Bitbucket?
Merges a PR using the configured strategy (merge_commit, squash, fast_forward). Requires CI to pass and reviewers to approve per branch protection. Useful for auto-merge bots that wait for green CI + approvals and merge automatically.
What inputs does Merge Pull Request require?
Required: Workspace, Repository Slug, PR ID. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Bitbucket returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does Merge Pull Request support batch operations?
Yes. Run Merge Pull Request inside a Loop node to process arrays. Tiny Command handles Bitbucket's rate limits automatically so you don't have to throttle manually.
More actions
Other Bitbucket actions.
Action
Add PR Comment
Posts a comment on a pull request. Useful for AI-driven code-review bots, for cross-tool notifications ("Linear issue X closed → comment on the linked PR"), or for automated linting/style feedback.
ActionCreate Issue
Files a new issue in a Bitbucket repository with title, content, kind (bug/enhancement/task), priority, assignee. For "Sentry error → file a Bitbucket issue" or "support ticket marked as bug → file repo issue" workflows.
ActionCreate Pull Request
Opens a new PR from source branch to destination branch with title, description, and reviewers. Useful for automation that auto-creates PRs from generated branches (e.g., dependabot-style auto-update workflows).
ActionGet Pull Request
Returns the PR by ID with all metadata — branches, reviewers, status, merge conflicts, build status. The standard lookup for cross-tool sync workflows that need current PR state.
ActionGet Repository
Returns the repository with name, description, language, visibility, fork info, recent activity. Useful for "show me all repos this team owns" inventory workflows or for validating a repo exists before downstream operations.
ActionList Branches
Returns the repository's branches with last commit info. Useful for "find branches that haven't been touched in 90+ days for cleanup" maintenance workflows.
Send merge pull request from your workflows.
Triggered by anything in the catalog. Free tier available. No credit card.