Bitbucket offers integration with external services via a set of brokers. Each broker is a server-side post-receive service. After the server receives and finishes processing a push, it passes data to the services you choose. A broker is a simple Python script, that receives information about the push and then takes action. For example, there is a broker for sending email messages, another for posting information to an arbitrary URL, and another for posting updates to a Twitter account. This page contains the following information:
If you are having trouble with an existing service, see Troubleshoot Bitbucket services.
What triggers a post-receive service?
A service runs once Bitbucket receives data from you and other contributors to your project. Because of the decentralised nature of Git and Mercurial, you can commit something locally without notifying Bitbucket. It is not until you push your changesets to Bitbucket, that you actually connect to our servers and upload the commit data.
A service broker receives the push data only after the Bitbucket server successfully receives it. Since a push can contain multiple changesets, a service may receive more than one changeset. Some of the services take the number of changsets into consideration. For example, the email broker constructs different email messages based on the number of changesets.
Setting up a service
A repository administrator can enable services for a specific repository. Once you've configured a service, it is active.
- Go to the repository settings .
- Click Services on the right-hand side of the screen.
On the page, you will see a list (Select a service) of services available. You may add as many services as you want. You can even add many instances of the same type. For example, you can email several people or ping several different URLs.
- Select the service you want.
- Click Add service.
The system adds the service to the page.
- Scroll to the service you added.
- Enter additional configuration information as needed.
Details are in the separate sections per service, listed below.
- Click Save.
Follow the detailed instructions to set up the services you want:
- Troubleshoot Bitbucket services
- AgileZen service management
- Bamboo service management
- Basecamp classic service management
- Campfire service management
- Email Diff service management
- Email service management
- Flowdock service management
- FogBugz service management
- FriendFeed service management
- Geocommit service management
- Grove service management
- HipChat service management
- Jenkins service management
- Masterbranch service management
- POST service management
- Rietveld service management
- Set up the Issues service
- Set up the Lighthouse service
- Superfeedr service management
- Twitter service management
- Pull Request POST service management