1 files changed, 21 insertions, 0 deletions

diff --git a/docs/slack.markdown b/docs/slack.markdown
new file mode 100644
index 00000000..7d7777eb
--- /dev/null
+++ b/docs/slack.markdown
@@ -0,0 +1,21 @@
+Slack integration
+=================
+
+Send notifications to a channel
+-------------------------------
+
+Example of notifications:
+
+![Slack notification](http://kanboard.net/screenshots/documentation/slack-notification.png)
+
+This feature use the [Incoming webhook](https://api.slack.com/incoming-webhooks) system of Slack.
+
+### Configure Slack
+
+![Slack webhook creation](http://kanboard.net/screenshots/documentation/slack-add-incoming-webhook.png)
+
+1. Click on the Team dropdown and choose **Configure Integrations**
+2. On the list of services, scroll-down and choose **DIY Integrations & Customizations > Incoming WebHooks**
+3. Copy the webhook url to the Kanboard settings page: **Settings > Integrations > Slack**
+
+