How to trigger a jenkins pipeline from a bitbucket repository How to trigger a jenkins pipeline from a bitbucket repository jenkins jenkins

How to trigger a jenkins pipeline from a bitbucket repository


If your are looking for a full Bitbucket and Jenkins Pipeline, I highly recommend to use the Bitbucket Branch Source Plugin. The plugin will discover all Branches and Pull Requests and build all who have a JenkinsFile in the root of repo.

You can also use create a project as Bitbucket Team, who will scan all repo of your organization:enter image description here

See the official doc of CloudBees


I was struggling with the same problem. Following are the key points I followed.

In Jenkins pipeline job,

  1. Under Build Triggers, check 'Trigger builds remotely (e.g., from scripts)' and fill in the 'Authentication Token' with some random and unique token.

In BitBucket repository,

  1. Go to Settings > Services

  2. Select 'Jenkins' from the drop down and 'Add service'.

    • Check 'Csrf Enabled'

    • Endpoint : http://username:apitoken@yourjenkinsurl.com/

      You can find username and apitoken at Jenkins home > PeopleSelect the user and click on configure. Under 'API Token' click on the 'Show API Token' button and you see the username and apitoken

    • Module name : This is optional. It can be any particular file or folder which is to be watched.

    • Project name : The project name in Jenkins.

      If the job is in some folder structure, say I have 'MyTestFolder/MyTestPipelineJob', Project name to be mentioned is 'MyTestFolder/job/MyTestPipelineJob'

    • Token : 'Authentication Token' created in Jenkins job.

You are ready to go!!

I referred http://felixleong.com/blog/2012/02/hooking-bitbucket-up-with-jenkins/ and some of my instincts. :)


A simple solution is to use Generic Webhook Trigger Plugin in Jenkins.

You would need to

  • Enable it in a free style or pipeline job.
  • Configure a token string
  • Construct JSONPath:s to gather whatever you need from the Bitbucket Webhook.
  • Add the plugin endpoint in Bitbucket. JENKINS_URL/generic-webhook-trigger/invoke?token=whatever_you_picked

The plugin will give you clear feedback when it is invoked so that troubleshooting is made easy.

It is up to you to pick whatever values you need from the webhook in order to clone the correct repository or whatever it is you want to do when the it is invoked.