summaryrefslogtreecommitdiff
path: root/docs/bitbucket-webhooks.markdown
diff options
context:
space:
mode:
Diffstat (limited to 'docs/bitbucket-webhooks.markdown')
-rw-r--r--docs/bitbucket-webhooks.markdown40
1 files changed, 40 insertions, 0 deletions
diff --git a/docs/bitbucket-webhooks.markdown b/docs/bitbucket-webhooks.markdown
new file mode 100644
index 00000000..fbb80d12
--- /dev/null
+++ b/docs/bitbucket-webhooks.markdown
@@ -0,0 +1,40 @@
+Bitbucket webhooks
+==================
+
+Bitbucket events can be connected to Kanboard automatic actions.
+
+List of supported events
+------------------------
+
+- Bitbucket commit received
+
+List of supported actions
+-------------------------
+
+- Close a task
+
+Configuration
+-------------
+
+![Bitbucket configuration](http://kanboard.net/screenshots/documentation/bitbucket-webhooks.png)
+
+1. On Kanboard, go to the project settings and choose the section **Integrations**
+2. Copy the Bitbucket webhook url
+3. On Bitbucket, go to the project settings and go to the section **Hooks**
+4. Select the service **POST**
+5. Paste the url and save
+
+Examples
+--------
+
+### Close a Kanboard task when a commit pushed to Bitbucket
+
+- Choose the event: **Bitbucket commit received**
+- Choose the action: **Close the task**
+
+When one or more commits are sent to Bitbucket, Kanboard will receive the information, each commit message with a task number included will be closed.
+
+Example:
+
+- Commit message: "Fix bug #1234"
+- That will close the Kanboard task #1234