Bitbucket
The Bitbucket modules enable you to monitor repositories, users or teams, and create, update, retrieve, or delete issues, snippets or milestones in your Bitbucket account.
Getting Started with Bitbucket
Prerequisites
- A Bitbucket account
In order to use Bitbucket with Integromat, it is necessary to have a Bitbucket account. If you do not have one, you can create a Bitbucket account at bitbucket.org/account/signup.
Connecting Bitbucket to Integromat
To connect your Bitbucket account to Integromat follow the general instructions for Connecting to services.
After you click the Continue button, Integromat will redirect you to the Bitbucket website where you will be prompted to grant Integromat access to your account.
Confirm the dialog by clicking the Grant Access button.
Watch
Watch Repository
Triggers when specified events occur in the repository.
Webhook name | Enter the name for the webhook. E.g. New Issue. |
Connection | Establish a connection to your Bitbucket account. |
Repository | Select the repository you want to watch for events. |
Events | Choose the Bitbucket events that will trigger the module. |
You can check that the webhook was created in the repository settings of your Bitbucket account.
Watch a User
Triggers when the specified event occurs in all repositories that belong to your account. Creates a new webhook for the specified user account.
Webhook name | Enter the name for the webhook. E.g. New Issue. |
Connection | Establish a connection to your Bitbucket account. |
Events | Choose Bitbucket events that will trigger the module. |
Watch a Team
Triggers when the specified event occurs in all repositories that belong to the selected team.
Webhook name | Enter the name for the webhook. E.g. New Issue. |
Connection | Establish a connection to your Bitbucket account. |
Team | Select the team you want to monitor events for. |
Events | Choose Bitbucket events that will trigger the module. |
Issue
Create an Issue
Creates a new issue.
reporter
field in the issue's details (Bitbucket UI).Connection | Establish a connection to your Bitbucket account. |
Repository | Select the repository where you want to create a new issue. |
Title | Enter the title of the issue. |
Raw | Enter the description of the issue. |
Markup | Select the markup language you want to use to format the issue description. |
Kind | Select whether the issue is a bug, enhancement, proposal, or task. |
Priority | Set the issue priority. |
Username | Enter the user name of the user you want to assign the issue to. The user name can be found in the user profile settings. |
State | Select the state of the issue. |
Component | A component as defined in the repository's issue tracker. |
Milestone | A milestone as defined in the repository's issue tracker. |
Version | A version as defined in the repository's issue tracker. |
Get an Issue
Retrieves the details of an issue.
Connection | Establish a connection to your Bitbucket account. |
Repository | Select or map the repository that contains the issue you want to retrieve. |
Issue ID | Enter (map) or select the issue you want to retrieve details about. |
List Issues
Retrieves all issues within the selected repository.
Connection | Establish a connection to your Bitbucket account. |
Repository | Select or map the repository you want to retrieve issues from. |
Limit | Set the maximum number of issues Integromat will return during one execution cycle. |
Update an Issue
Updates the specified issue.
Connection | Establish a connection to your Bitbucket account. |
Repository | Select or map the repository that contains the issue you want to update. |
Issue ID | Enter (map) or select the issue you want to update. |
Please find the descriptions of the fields in the Create an Issue section above.
Delete an Issue
Deletes a specified issue.
Connection | Establish a connection to your Bitbucket account. |
Repository | Select or map the repository that contains the issue you want to delete. |
Issue ID | Enter (map) or select the issue you want to delete. |
Create an Issue Comment
Adds a comment to the issue.
Connection | Establish a connection to your Bitbucket account. |
Repository | Select or map the repository that contains the issue you want to add a comment to. |
Issue ID | Enter (map) or select the issue you want to add a comment to. |
Raw | Enter the text content of the comment. |
Markup | Specify the markup you want to use for formatting the comment. |
Milestone
List Milestones
Retrieves all milestones within the specified repository.
Connection | Establish a connection to your Bitbucket account. |
Repository | Select or map the repository you want to retrieve milestones from. |
Limit | Set the maximum number of milestones Integromat will return during one execution cycle. |
Get a Milestone
Retrieves milestone details.
Connection | Establish a connection to your Bitbucket account. |
Repository | Select or map the repository that contains the milestone you want to retrieve. |
Issue ID | Enter (map) or select the milestone you want to retrieve details about. |
List Repository Watchers
Returns a list of all the watchers of the specified repository.
Connection | Establish a connection to your Bitbucket account. |
Repository | Select or map the repository you want to retrieve repository watchers from. |
Limit | Set the maximum number of repository watchers Integromat will return during one execution cycle. |
File
Get a File
Downloads a file from the repository.
Connection | Establish a connection to your Bitbucket account. |
Repository | Select or map the repository that contains the file you want to download. |
File Name | Enter the file name of the file you want to download. |
Snippet
List Snippets
Retrieves all snippets for the specified user.
Connection | Establish a connection to your Bitbucket account. |
User Name | Select or map the user name you want to retrieve snippets for. |
Role | Select your role to filter returned snippets.
When no role is specified, all public snippets are returned, as well as all privately owned snippets watched or commented on. |
Limit | Set the maximum number of snippets Integromat will return during one execution cycle. |
Get a Snippet
Retrieves the details of a snippet.
Connection | Establish a connection to your Bitbucket account. |
User Name | Select or map the user or team name the snippet you want to retrieve belongs to. |
Snippet ID | Enter (map) or select the ID of the snippet you want to retrieve details about. |
Start Watching a Snippet
Starts watching the specified snippet.
Connection | Establish a connection to your Bitbucket account. |
User Name | Select or map the user name associated with the snippet. |
Role | Select your role for the snippet. |
Snippet ID | Enter (map) or select the ID of the snippet you want to start watching. |
Stop Watching a Snippet
Stops watching the specified snippet.
Connection | Establish a connection to your Bitbucket account. |
User Name | Select or map the user name associated with the snippet. |
Role | Select your role for the snippet. |
Snippet ID | Enter (map) or select the ID of the snippet you want to stop watching. |
List Snippet Watchers
Retrieves all users that are watching a specified snippet.
Connection | Establish a connection to your Bitbucket account. |
Snippet ID | Enter (map) or select the ID of the snippet you want to retrieve users from. |
Limit | Set the maximum number of users Integromat will return during one execution cycle. |
Create a Comment on a Snippet
Adds a comment to the specified snippet.
Connection | Establish a connection to your Bitbucket account. |
User Name | Select or map the user name. |
Snippet ID | Enter (map) or select the snippet you want to add a comment to. |
Raw | Enter the text content of the comment. |
Markup | Specify the markup you want to use for formatting the comment. |
Comment ID | If you want to post your comment as a reply, enter (map) the comment you want to reply to. |
Make an API Call
Allows you to perform a custom API call.
Connection | Establish a connection to your Bitbucket account. |
URL | Enter a path relative to For the list of available endpoints, refer to the Bitbucket API docs. |
Method | Select the HTTP method you want to use: GET POST PUT PATCH DELETE |
Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String | Enter the request query string. |
Body | Enter the body content for your API call. |
Example of Use - List Teams
The following API call returns the list of all teams where your role is admin:
URL teams
Query String
Key: role
Value: admin
Matches of the search can be found in the module's Output under Bundle > Body > values.
In our example, 2 teams were returned: