Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Wiki Markup
This pipeline plugin provides an easy way to block a build pipeline until an external system posts to a webhook. This can be used to integrate long running tasks into a pipeline, without busy waiting.


For example, the following pipeline script writes out the webhook url to the log and waits for a user to call it:

Code Block

hook = registerWebhook()

echo "Waiting for POST to ${hook.getURL()}"

data = waitForWebhook hook
echo "Webhook called with data: ${data}"

When this job is executed, something like the following log is printed:

Code Block

Waiting for POST to http://localhost:8080/webhook-step/bef13807-a161-4193-ab95-6cb974afc71d

To continue the pipeline, we can post to this url. To do this with curl, execute curl -X POST -d 'OK' http://localhost:8080/webhook-step/bef13807-a161-4193-ab95-6cb974afc71d. Looking back at the Jenkins Job, it should now have completed and logged Webhook called with data: OK.

Version History

Version 1.3 (October 2017)

  • Minor bug fix release for HTTP Posts that do not include body size

Version 1.1 (March 2017)

  • Relaxed versions of required dependencies